SuperAPI AI 工具集

add-skill

智能体与模型

查看项目

更新于 10-15 22:14

技能介绍

用途:按官方规范创建结构正确的 Claude Code 技能(skills)或斜杠命令。

快速模式:可一次性提供全部信息,直接解析生成、不进入交互提问,例如:/add-skill name=my-skill purpose="Does X" trigger="when user asks for Y"

工作流程:

  1. 先抓取官方文档以符合当前规范:WebFetch https://code.claude.com/docs/en/skills,提取文件格式、必填字段、命名规则与最佳实践;若失败则回退 WebSearch: "Claude Code skills SKILL.md format site:code.claude.com"。
  2. 收集需求:作用范围(全局 ~/.claude/skills/{skill-name}/,或仓库内 .claude/skills/{skill-name}/)、名称、用途、触发条件、复杂度、自由度。
  3. 创建结构:{base-path}/skills/{skill-name}/ 下含必需的 SKILL.md(少于 500 行),可选 scripts/ 与 references/(仅一层)。
  4. 生成 SKILL.md:包含 name 与 description 前置字段,正文含概述、Quick Start、Instructions、Advanced Features 等。
  5. 行数检查与渐进披露:接近或超过 500 行时提示,将可拆分内容移入 references/{topic}.md 并以摘要加链接替代,超 100 行的引用文件加目录。
  6. 校验:按清单检查命名、描述、正文长度、示例、脚本等。
  7. 验证:ls -la ~/.claude/skills/{skill-name}/、cat ~/.claude/skills/{skill-name}/SKILL.md,并用 claude --debug 检查加载错误。

命名规则:1-64 字符,仅小写字母、数字、连字符,推荐动名词形式;不得以连字符开头或结尾、不得连续 --、不得含保留字(anthropic、claude)与 XML 标签,需与文件夹名一致。

描述规则:不超过 1024 字符,非空,无 XML 标签,使用第三人称,同时说明做什么与何时使用。

限制与注意:不得编造未提供的收费、平台或效果信息;连接路径使用正斜杠;MCP 工具引用使用全限定名 ServerName:tool_name。