SuperAPI AI 工具集

creating-agent-skills

编程与开发

查看项目

更新于 10-16 07:38

技能介绍

本技能旨在帮助用户按照 Anthropic 的官方规范创建、编写和改进 Claude Code Skills(技能)。

一、用途 用于指导技能创作的全流程,包括制定新技能、审计既有技能、添加工作流/参考/示例组件,以及理解技能设计原则。

二、核心原则

  1. 技能即提示词:所有提示词最佳实践都适用,需清晰、直接,默认 Claude 足够聪明,只补充其不具备的上下文。
  2. 标准 Markdown 格式:使用 YAML frontmatter 加 Markdown 正文,不使用 XML 标签,改用标准 Markdown 标题。
  3. 渐进式披露:SKILL.md 保持在 500 行以内,将详细内容拆分到参考文件,按需加载。典型结构包含 SKILL.md(入口,必需)、reference.md(详细文档,按需加载)、examples.md(使用示例)以及 scripts/(工具脚本,直接执行而不加载)。
  4. 有效描述:description 字段用于技能发现,需同时说明技能做什么和何时使用,并使用第三人称。示例中给出正例(如“Extracts text and tables from PDF files...”)与反例(如“Helps with documents”)。

三、技能结构 必填 frontmatter 字段包括:name(必需,最长 64 字符,仅小写字母、数字、连字符)、description(必需,最长 1024 字符,说明做什么和何时用)、allowed-tools(可选,Claude 无需询问即可使用的工具)、model(可选,指定使用的模型)。 命名约定:使用动名词形式(动词 + -ing),如 processing-pdfs、analyzing-spreadsheets、generating-commit-messages、reviewing-code;避免使用 helper、utils、tools、anthropic-、claude-。 正文结构采用标准 Markdown 标题:技能名、快速开始、指令、示例、高级功能、指南。

四、使用方式 创建新技能分为五步:第 1 步选择类型(单文件简单技能或渐进式披露的多文件技能);第 2 步创建 SKILL.md(含 frontmatter、快速开始、指令、示例、指南);第 3 步按需添加参考文件,从 SKILL.md 链接,保持引用与 SKILL.md 仅一层深度;第 4 步按需添加脚本,脚本执行时不加载进上下文;第 5 步用真实任务测试,观察 Claude 在何处遇到困难,并分别在 Haiku、Sonnet 和 Opus 上测试。 审计既有技能时对照清单:有效的 YAML frontmatter、描述包含触发关键词、使用标准 Markdown 标题、SKILL.md 在 500 行以内、引用一层深度、示例具体、术语一致、无时效性信息、脚本显式处理错误。

五、适用场景 适用于编写 SKILL.md 文件、编写新技能、改进现有技能、设计技能结构,以及需要在不同模型上验证技能表现的场景。

六、常见模式 包括模板模式(提供输出模板保证一致性)、工作流模式(复杂多步任务使用检查清单并逐步展开)、条件模式(在决策点引导选择不同路径)。

七、限制与反模式 需避免:正文使用 XML 标签、描述模糊、嵌套过深、选项过多、使用 Windows 路径、把错误处理推给 Claude、包含时效性信息。参考文件提供 official-spec.md(官方规范)与 best-practices.md(最佳实践)。

八、成功标准 结构良好的技能应具备有效 YAML frontmatter、标准 Markdown 标题、SKILL.md 在 500 行以内、引用详细内容、含输入/输出示例、并经过真实使用测试。