SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场agent-skill-builder

agent-skill-builder

智能体与模型

查看项目

更新于 10-16 02:12

技能介绍

用途

Agent Skill Builder 用于快速搭建新的 Claude Code 技能，或把已有的 ChatGPT 项目转换为 Claude Code 技能格式。它聚焦于快速创建和结构正确；如果需要迭代测试、基准评测和描述优化，资料建议使用 Anthropic 官方的 skill-creator 插件。

两种模式

  • 模式一：创建新技能（/agent-skill-builder new [name]）——以正确的结构和最佳实践搭建一个全新的 Claude Code 技能。
  • 模式二：翻译 ChatGPT 项目（/agent-skill-builder translate [name]）——把现有的 ChatGPT 项目转换为 Claude Code 技能。

创建新技能的流程

  1. 收集意图：向用户询问技能名称（/slash-command 叫什么）、用途、实际使用示例、触发词；上下文中已明确的可跳过。
  2. 规划资源：分析每个示例，确定需要打包的内容——脚本（scripts/，重复编写或需要确定性可靠性的代码，执行时不加载进上下文）、参考文档（references/，Claude 工作时查阅的文档，按需加载）、资源文件（assets/，输出中使用的模板、图片、字体，不加载进上下文）。
  3. 创建目录与 SKILL.md：使用 mkdir -p ~/.claude/skills/[skill-name] 创建目录，并按模板编写 SKILL.md，frontmatter 包含 name 与 description，正文包含 Instructions、Output Format、Constraints 等部分。
  4. 添加参考文件（如需要）：多领域或多变体的技能应保持 SKILL.md 精简，拆分为 references/ 下的文件，SKILL.md 中给出何时读取各文件的清晰指引，引用保持一层深度。
  5. 测试：直接调用 /skill-name，或让 Claude 通过匹配 description 关键词自动调用，检查技能在预期时触发、不相关时保持静默。

翻译 ChatGPT 项目的流程

  1. 提取 ChatGPT 组件：向用户索取系统提示/指令、知识文件（PDF、文档）、对话开场白（可选）、Actions/API 配置（如有）。
  2. 映射组件：名称→frontmatter 的 name；描述→frontmatter 的 description；指令→SKILL.md 正文；知识文件→references/ 文件夹（转为 .md）；对话开场白→写入 Examples 部分或省略；Actions（API）→MCP 服务器（~/.claude/mcp.json）；Code Interpreter→原生工具 Bash、Read、Write、Edit、Glob、Grep；Memory→无直接对应，使用上下文文件或技能背景部分。
  3. 转换指令："You are a [role]..."→Role 部分或融入指令；"Your task is to..."→Instructions 部分；"Always/Never..."→Constraints 部分；"Output format..."→Output Format 部分；输入占位符 [text] 保持原样或使用 $ARGUMENTS。
  4. 转换知识文件：PDF/文档转为 Markdown 放入 references/；大文件（超过 1 万词）在 SKILL.md 中包含 grep 搜索模式；超过 100 行的文件在顶部添加目录；模板和资源放入 assets/。
  5. 编写 frontmatter：description 是主要触发机制，用第三人称写，包含技能做什么和何时使用，触发词可稍微"主动"一些以对抗触发不足。

Frontmatter 参考

只有 name 和 description 是必填项，其余为 Claude Code 特有扩展：

  • name（必填）：最多 64 字符，仅小写字母、数字和连字符。
  • description（必填）：最多 1024 字符，包含 What + When，第三人称，主要触发机制。
  • argument-hint（可选）：自动补全中显示的提示，如 "[issue-number]"。
  • disable-model-invocation（可选）：true 表示仅用户可调用（不自动触发）。
  • user-invocable（可选）：false 表示仅 Claude 可调用（从斜杠命令菜单隐藏）。
  • context（可选）：fork 表示在隔离子智能体中运行。
  • agent（可选）：子智能体类型：Explore、Plan、general-purpose。
  • allowed-tools（可选）：限制可用工具，如 Read、Grep、Glob。
  • model（可选）：为此技能覆盖模型。

字符串替换

  • $ARGUMENTS：/skill-name 之后的所有内容。
  • ${CLAUDE_SESSION_ID}：当前会话 ID。
  • !command：动态注入（在技能加载前运行）。

技能位置

  • 个人：~/.claude/skills/[name]/，作用于所有项目。
  • 项目：.claude/skills/[name]/，仅作用于当前项目。

编写最佳实践

来自 Anthropic 官方技能编写指南：简洁是关键，Claude 本身已足够聪明，只添加它尚不具备的上下文，优先使用简洁示例而非冗长解释；description 决定一切，Claude 会从可能 100 多个可用技能中依据描述选择，要具体、包含触发关键词、用第三人称；渐进式披露，SKILL.md 保持在 500 行以内，详细参考移到单独文件按需加载；让自由度匹配脆弱性，灵活任务用高自由度（文本指令），脆弱操作用低自由度（具体脚本）；解释原因，说明指令背后的理由而非使用强硬的 MUST；术语一致，选定一个术语贯穿全文；不要多余文件，不放 README.md、CHANGELOG.md、INSTALLATION_GUIDE.md，技能只包含 AI 智能体完成工作所需的内容；只用正斜杠，使用 scripts/helper.py，绝不用 scripts\helper.py。

提示词骨架

每个技能提示词和每个 ChatGPT 或 Claude 项目提示词都使用相同的五个块，按此顺序：

  1. Goal（目标）：一到两句话说明提示词产出什么、给谁用。
  2. Persona（角色）：智能体扮演谁，以及这个人如何看待工作。
  3. Chat protocol（对话协议）：对话如何运行——每条消息一个问题，每条消息顶部标注阶段名称，每个阶段前有简短说明，以及阶段后如何检查结果。
  4. Stages（阶段）：编号阶段，每个阶段以停止点结束，智能体等待用户批准（"go"）后才开始下一阶段。
  5. Hard rules（硬性规则）：智能体绝不做的事情，写成平实的规则。

骨架内还有两条规则：修订轮次有上限，每个阶段允许一到两轮修改后继续，并在阶段中说明上限；不得编造，智能体绝不编造事实、数据、名称或数字，缺失时标记缺口（例如 [MISSING: price]）并询问，而不是自行填充。当阶段之间需要交接时，让每个阶段写一个 markdown 文件供下一阶段读取。

创建后检查清单

  • SKILL.md 已创建，frontmatter 中包含 name 和 description。
  • description 包含 What 和 When（触发词），用第三人称书写。
  • SKILL.md 在 500 行以内。
  • 知识文件已转换为 Markdown 放入 references/。
  • 引用距 SKILL.md 只有一层深度。
  • 大参考文件（超过 100 行）有目录。
  • 提示词遵循五块骨架，包含停止点、有上限的修订轮次和不得编造规则。
  • 技能已用 /skill-name 和自动调用测试。
  • 没有多余文档文件。

适用场景与限制

适用于需要快速创建 Claude Code 技能、或把 ChatGPT 项目迁移到 Claude Code 技能格式的用户。资料未提供该技能的收费、价格、平台支持范围或效果数据；其迭代测试、基准评测和描述优化能力明确建议改用 Anthropic 官方 skill-creator 插件。