SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-15 16:02

技能介绍

skill-creator 是一个指导如何创建有效技能的技能。技能是模块化、自包含的包,通过提供专门的知识、工作流和工具来扩展 Claude 的能力,可以理解为特定领域或任务的“入职指南”,把通用智能体转变为具备程序性知识的专用智能体。

【技能能提供什么】

  • 专门工作流:面向特定领域的多步骤流程。
  • 工具集成:处理特定文件格式或 API 的说明。
  • 领域专长:公司特定知识、模式、业务逻辑。
  • 捆绑资源:面向复杂或重复任务的脚本、参考资料和资产。

【核心原则】 简洁是关键:上下文窗口是公共资源,只添加 Claude 原本不具备的上下文,优先用简洁示例而非冗长解释。同时需要设置合适的自由度:高自由度(基于文本的说明)适用于多种方案都可行的场景;中自由度(伪代码或带参数脚本)适用于存在偏好模式但允许变化的场景;低自由度(具体脚本、少量参数)适用于操作脆弱、需严格一致的场景。

【技能的结构】 每个技能由必需的 SKILL.md 文件和可选的捆绑资源组成: skill-name/ ├── SKILL.md(必需) │ ├── YAML frontmatter 元数据(必需) │ │ ├── name(必需) │ │ └── description(必需) │ └── Markdown 说明(必需) └── 捆绑资源(可选) ├── scripts/ - 可执行代码(Python/Bash 等) ├── references/ - 按需加载到上下文的文档 └── assets/ - 用于输出的文件(模板、图标、字体等)

SKILL.md 的 frontmatter 只包含 name 和 description 两个字段,它们决定技能何时被使用,因此必须清晰完整地描述技能是什么、何时使用。Body 部分仅在技能触发后加载。

【捆绑资源】

  • scripts/:适合需要确定性可靠或反复重写的任务,优点是节省 token、可执行而无需加载到上下文。
  • references/:供 Claude 工作时参考的文档,如数据库模式、API 文档、领域知识、公司政策、详细工作流指南。最佳实践:若文件超过 1 万词,在 SKILL.md 中提供 grep 搜索模式。注意避免信息在 SKILL.md 与 references 中重复。
  • assets/:不加载进上下文,而是用于 Claude 产生的输出,如品牌资产、PowerPoint 模板、HTML/React 样板、字体、模板图片等。

【不应包含的内容】 技能只应包含直接支持其功能的必要文件,不要创建 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档或辅助文件。

【渐进式披露设计原则】 技能采用三级加载:元数据(name + description,始终在上下文中,约 100 词);SKILL.md 正文(技能触发时加载,少于 5k 词);捆绑资源(按需加载,因脚本可执行而不受上下文限制)。SKILL.md 正文应保持精炼并少于 500 行,接近上限时拆分到单独文件,并在 SKILL.md 中引用并说明何时阅读。常见模式包括:高层指南加引用、按领域组织内容、条件细节。避免深层嵌套引用,保持引用距 SKILL.md 一层;超过 100 行的参考文件应在顶部加入目录。

【技能创建流程】

  1. 用具体示例理解技能:明确技能将如何被使用,可来自用户示例或经用户反馈验证的生成示例,避免单条消息问太多问题。
  2. 规划可复用内容:分析每个示例,确定有帮助的脚本、参考和资产。
  3. 初始化技能:运行 scripts/init_skill.py <skill-name> --path <output-directory>,脚本会创建技能目录、生成带 frontmatter 与 TODO 占位符的 SKILL.md 模板,并创建 scripts/、references/、assets/ 示例目录。
  4. 编辑技能:先实现可复用内容,添加的脚本需实际运行测试;删除不需要的示例文件;按命令式/不定式风格编写 SKILL.md,description 中写明技能做什么以及何时使用,不要在其他位置放置“何时使用”。
  5. 打包技能:运行 scripts/package_skill.py <path/to/skill-folder>,可选指定输出目录,脚本会自动校验 YAML frontmatter 格式与必填字段、命名规范与目录结构等,并生成可分发的 .skill 文件。
  6. 根据实际使用迭代。

【限制与未知】 资料未提供该技能的收费、价格、平台、具体安装命令之外的部署细节或效果保证,相关内容暂未提供。