skill-forge

Skill Forge — 终极 Claude Code 技能创建工具

遵循 Agent Skills 开放标准、渐进式披露架构，以及 claude-seo 和 claude-ads 等高性能技能经过实战验证的模式，构建生产级 Claude Code 技能。

快速参考

命令	功能
/skill-forge	交互式技能创建向导
/skill-forge plan <domain>	架构与设计规划
/skill-forge build <name>	根据计划搭建并构建技能
/skill-forge review <path>	审查现有技能的质量
/skill-forge evolve <path>	根据反馈／问题改进技能
/skill-forge eval <path>	运行评估流程，测试技能质量
/skill-forge benchmark <path>	对技能进行基准测试并分析差异
/skill-forge publish <path>	打包技能并准备分发
/skill-forge convert <path>	将技能转换为 Codex/Gemini/Antigravity/Cursor 格式

编排逻辑

交互模式（/skill-forge）

引导用户完成完整的技能创建生命周期：

1. 需求探索：询问领域、使用场景和目标用户
2. 架构设计：确定技能复杂度层级并设计结构
3. 构建：根据所选模板生成所有文件
4. 审查：验证结构、frontmatter、触发条件和质量
5. 评估：通过断言和评分运行评估流程
6. 基准测试：通过差异分析测量通过率、时间和令牌数
7. 迭代：根据评估结果和反馈进行优化

命令路由

对于特定命令，加载相关子技能：

• /skill-forge plan -> skills/skill-forge-plan/SKILL.md
• /skill-forge build -> skills/skill-forge-build/SKILL.md
• /skill-forge review -> skills/skill-forge-review/SKILL.md
• /skill-forge evolve -> skills/skill-forge-evolve/SKILL.md
• /skill-forge eval -> skills/skill-forge-eval/SKILL.md
• /skill-forge benchmark -> skills/skill-forge-benchmark/SKILL.md
• /skill-forge publish -> skills/skill-forge-publish/SKILL.md
• /skill-forge convert -> skills/skill-forge-convert/SKILL.md

技能复杂度层级

根据用户描述检测合适的层级：

层级 1：单一技能（1 个 SKILL.md）

• 简单的工作流或文档生成
• 无需子技能或子 Agent
• 指令少于 200 行
• 模板：assets/templates/minimal.md

层级 2：技能 + 脚本（SKILL.md + scripts/）

• 需要确定性执行（验证、数据处理）
• 使用 Python/Bash 脚本处理脆弱操作
• 模板：assets/templates/workflow.md

层级 3：多技能编排器（主技能 + 子技能）

• 涉及多个不同工作流的复杂领域
• 主技能将请求路由到专用子技能
• 子技能之间共享参考资料
• 模板：assets/templates/multi-skill.md

层级 4：完整生态系统（编排器 + 子技能 + Agent + 脚本）

• 企业级技能，支持并行委派给子 Agent
• 用于确定性任务的多个执行脚本
• 行业模板和参考知识
• 模板：assets/templates/ecosystem.md

核心原则（所有生成的技能都必须遵守）

1. 渐进式披露（3 个层级）

• 层级 1（frontmatter）：始终包含在系统提示词中。仅包含名称和描述（约 50-100 个令牌）
• 层级 2（SKILL.md 正文）：激活时加载。核心指令（少于 500 行、少于 5000 个令牌）
• 层级 3（references/scripts/assets）：按需加载。详细知识和执行内容

2. 描述为王

description 字段决定技能何时激活。必须包含：

• 技能的功能（能力）
• 使用时机（用户可能会说的触发短语）
• 用于匹配的关键领域关键词

阅读 references/description-guide.md 了解完整框架。

3. 三层架构

• 第 1 层（指令）：SKILL.md 指令、参考文件 = “做什么”
• 第 2 层（编排）：Claude 的路由和决策 = “怎么做”
• 第 3 层（执行）：scripts/ 中的脚本 = “执行”

将确定性工作交给脚本处理。将概率性决策留在指令中。

4. 命名约定

• 技能文件夹：kebab-case（仅限小写字母和连字符）
• Name 字段必须与文件夹名称完全一致
• 子技能：{parent}-{child}（例如，seo-audit、ads-google）
• Agent：agents/{skill}-{role}.md（例如，agents/seo-technical.md）
• 技能名称中不得包含 “claude” 或 “anthropic”（保留名称）

5. 文件规则

• 必需文件：SKILL.md（大小写必须完全一致）
• 技能文件夹中不得有 README.md
• frontmatter 中不得包含 XML 尖括号
• 参考文件：内容聚焦、篇幅精简，按需加载
• 脚本：功能单一、可测试、有完善文档

质量门槛

将生成的技能标记为完成前，请确保：

• SKILL.md 存在且包含有效的 YAML frontmatter
• Name 符合有效的 kebab-case 格式（1–64 个字符）
• Description 包含 WHAT + WHEN + 关键词（少于 1024 个字符）
• frontmatter 中不含 XML 标签
• 指令具体且可执行（不含含糊内容）
• 包含常见故障的错误处理
• 为关键工作流提供示例
• SKILL.md 正文少于 500 行
• 详细知识通过链接引用文件（而非直接内嵌）
• 脚本包含文档字符串、类型提示和错误处理

运行 python scripts/validate_skill.py <path> 以通过程序验证。

参考文件

按需加载，不要在启动时全部加载：

• references/anatomy.md -- 技能文件结构、命名规则、Agent 格式
• references/patterns.md -- 经过验证的工作流模式及示例
• references/frontmatter-spec.md -- YAML frontmatter 规范（技能）
• references/description-guide.md -- 编写针对触发优化的描述
• references/testing-guide.md -- 测试方法和检查清单
• references/pro-agent.md -- 三层架构深入解析
• references/tools-reference.md -- 所有工具名称、权限模式、MCP
• references/hooks-reference.md -- Hook 事件、类型、质量门槛模式
• references/skills-activation.md -- 技能发现、激活和高级功能
• references/platforms.md -- 平台规范和转换规则

子技能

此技能编排 8 个专用子技能：

1. skill-forge-plan -- 架构设计和用例规划
2. skill-forge-build -- 搭建框架并生成技能文件
3. skill-forge-review -- 审核并验证现有技能
4. skill-forge-evolve -- 根据反馈改进技能
5. skill-forge-eval -- 使用断言和评分运行评估流程
6. skill-forge-benchmark -- 通过方差分析对性能进行基准测试
7. skill-forge-publish -- 打包并准备分发
8. skill-forge-convert -- 将技能转换为 Codex、Gemini CLI、Antigravity、Cursor 格式