中文 | English
\n\nAgenticFORGE 的可组合、可路由 Agent 能力系统。将每种能力定义为一个聚焦的 **Skill** —— 用 Markdown 或 TypeScript —— 让框架自动把用户请求路由到最合适的那个。\n\n## 安装\n\n```bash\nnpm install @agenticforge/skills\n```\n\n---\n\n## 什么是 Skill？\n\nSkill 是一个具名、自包含的能力单元。把它想象成一个专家，你的 Agent 可以把具体问题委托给他：\n\n- 一个**天气 Skill**，只处理天气相关问题\n- 一个**代码审查 Skill**，专门评审 TypeScript 代码\n- 一个**股票查询 Skill**，查询实时行情数据\n\n每个 Skill 拥有自己的系统提示词、工具集和执行逻辑。用户请求到来时，框架自动路由到最匹配的 Skill。\n\n---\n\n## 定义 Skill\n\n### 方式 1 — Markdown（大多数场景推荐）\n\n创建一个 `SKILL.md` 文件。frontmatter 定义路由元数据，正文成为系统提示词。\n\n```markdown\n---\nname: code-reviewer\ndescription: 审查 TypeScript 和 JavaScript 代码，发现 Bug、类型安全问题和性能隐患。\ntriggerHint: 当用户要求审查、检查或改善代码质量时\n---\n\n# 代码审查员\n\n你是一位资深 TypeScript 工程师，正在进行严格的代码审查。\n优先关注正确性，其次是性能，最后是代码风格。\n\n## 审查清单\n- 类型安全：无隐式 `any`，返回值类型明确\n- 错误处理：无未处理的 Promise rejection\n- 边界条件：null/undefined、空数组\n\n## 输出格式\n1. **总体评价** — 一句话总结\n2. **问题列表** — 每条包含严重程度和修复建议\n3. **改进后的代码** — 重写有问题的部分\n```\n\n加载并运行：\n\n```ts\nimport { SkillLoader, SkillRunner } from \"@agenticforge/skills\";\n\nconst skills = await SkillLoader.fromDirectory(\"./skills\");\nconst runner = new SkillRunner({ llm, skills });\n\nconst result = await runner.run(\n \"帮我审查这个函数：async function fetchUser(id) { return fetch('/api/' + id).then(r => r.json()); }\"\n);\nconsole.log(result.output);\n```\n\n### 方式 2 — TypeScript 类\n\n```ts\nimport { AgentSkill } from \"@agenticforge/skills\";\nimport type { SkillContext, SkillResult } from \"@agenticforge/skills\";\nimport type { LLMClient } from \"@agenticforge/core\";\n\nclass StockSkill extends AgentSkill {\n constructor() {\n super({\n name: \"stock-query\",\n description: \"查询任意股票代码的实时价格和市场数据。\",\n triggerHint: \"当用户询问股票价格、市值、代码或交易数据时\",\n });\n }\n\n override async execute(ctx: SkillContext, llm: LLMClient): Promise