SuperAPI AI 工具集

skill-forge

智能体与模型

查看项目

更新于 10-16 10:14

技能介绍

用途

Skill Forge 是一套为 Claude Code 创建技能的指导流程,目标是把 Claude 从通用智能体转化为具备流程知识、领域专长和捆绑工具的专用智能体。它的定位是「技能开发向导」,而非某个具体业务功能的技能。

核心的 IRON LAW 是:技能中的每一行都必须证明其 token 成本合理。如果某行不能让模型输出更好、更一致或更可靠,就删掉它。默认假设是 Claude 已经很聪明,只需补充它原本不知道的内容。

主要能力

技能结构约定:

skill-name/
├── SKILL.md           # Required: workflow + instructions (<500 lines)
├── scripts/           # Optional: deterministic, repeatable operations
├── references/        # Optional: loaded into context on demand
└── assets/            # Optional: used in output, never loaded into context

指导内容覆盖:技能架构规划、渐进式加载策略、描述撰写(含 keyword bombing 技巧)、SKILL.md 正文写法、参数系统、资源构建与打包校验。

使用方式

内置一个九步清单式工作流:

  • Step 1 理解技能(必需):明确用途与具体用例,收集 3 个以上真实使用示例,识别触发场景与关键词。
  • Step 2 规划架构:区分确定性可重复操作(scripts/)、特定步骤所需领域知识(references/)、仅用于输出而不参与推理的文件(assets/)。
  • Step 3 初始化(阻塞项,技能已存在则跳过):运行 python3 scripts/init_skill.py <skill-name> --path <output-directory>。
  • Step 4 撰写描述:加载 references/description-guide.md,应用关键词技巧。关键规则是不要把「When to Use」信息放进 SKILL.md 正文,因为正文在触发之后才加载。
  • Step 5 撰写 SKILL.md 正文:设置铁律、设计可跟踪的工作流清单、添加确认门、按需添加参数系统、应用写作技巧、添加反模式清单、添加交付前检查表。
  • Step 6 构建资源:实现并测试脚本、编写参考文件、准备 assets。
  • Step 7 评审(必需):运行交付前检查清单,向用户展示摘要并确认。
  • Step 8 打包:运行 python3 scripts/package_skill.py <path/to/skill-folder> [output-directory],脚本会自动校验,出错则修复后重跑。
  • Step 9 按真实使用迭代:发现模型卡壳或不一致之处,定位需要改进的工作流步骤,补充更具体的指令、示例或反模式,再测试并重新打包。

写作原则包括:简明(只加 Claude 不知道的内容)、祈使句(「Analyze the input」而非「You should analyze the input」)、自由度与脆弱性匹配(高自由度用于文本等有多种有效路径的任务,中自由度用于伪代码或参数,低自由度用于脆弱操作并要求一致性)。

其他要求:SKILL.md 必须少于 500 行;references 按领域组织且只允许一层嵌套;超过 100 行的文件顶部需有目录;脚本需在打包前测试且不在上下文中加载,SKILL.md 中只记录命令与参数。

适用场景

需要为 Claude Code 构建带流程约束、领域知识和配套脚本的生产级技能时适用;也适用于改造已有技能,此时可跳过第 3 步初始化。

限制

资料未提供具体收费、价格、平台支持范围或效果数据。技能的具体实现细节依赖生成过程中加载的多个参考文件(description-guide、architecture-guide、writing-techniques、workflow-patterns、parameter-system、output-patterns),资料仅列出其加载时机,未给出这些文件的内容。