用途
create-skill 是一个研究优先（research-first）的流水线，用于产出符合 Agent Skills Specification 的 Agent Skills。它强调每个创建的技能都必须有引用的文档支撑，包含面向流程性任务的工作流模板，并且不允许智能体用模式（patterns）替代真实文档。
主要能力
- 按 9 个阶段顺序执行：Phase 0 加载技能开发指导、Phase 1 引导、Phase 2 安装 skill-creator、Phase 3 研究、Phase 4 需求、Phase 5 编写、Phase 6 skill-creator 优化、Phase 7 审查、Phase 8 精炼、Phase 9 报告。
- 按阶段按需加载参考文件，而非一次性全部加载。例如研究阶段加载 references/workflow-research.md，需求阶段加载 references/workflow-requirements.md，编写阶段加载 references/workflow-author.md 与 references/quality-criteria.md，审查阶段加载 references/workflow-review.md 与 references/quality-criteria.md，精炼阶段加载 references/workflow-refine.md 与 references/quality-criteria.md。
- 支持按技能类型跳过阶段：概念/方法论类可跳过脚本阶段与 shell-script-standards.md；简单技能（少于 4 个文件）可跳过任务跟踪；Claude 原生功能仅使用 Anthropic 文档，跳过外部文档研究；单一工具的纯包装可跳过工作流模板。
- 内置防幻觉规则：绝不对外部技术编造模式，始终引用文档 URL；不使用 curl/wget 下载代码，仓库用 git clone，文档用 WebFetch。
- 多步骤技能（3 个以上流程步骤）必须指示消费方智能体跟踪进度。
使用方式
- Phase 0：查找本地 skill-development 插件（~/.claude/plugins/ 下的 skill-development/SKILL.md）。若找到则调用 Skill("plugin-dev:skill-development") 并阅读其参考；若未找到则从官方插件市场获取指定 URL 的 SKILL.md 与 skill-creator-original.md。若获取失败则继续，并在需求文档中记录该缺口。
- Phase 1：运行
bash skills/create-skill/scripts/ensure_spec_repo.sh，确保 ~/.agent-skills-spec 包含最新的 Agent Skills Specification。若克隆/拉取失败，检查网络；离线时若已有旧数据可继续并注明，若完全不存在则警告用户无法验证规范符合性。 - Phase 2：检查 ~/.claude/skills/skill-creator/SKILL.md 是否存在，若不存在则运行
claude install-skill github:anthropics/skills/skills/skill-creator。若安装失败则跳过 Phase 6 并记录缺口。 - Phase 3：启动研究子智能体（general-purpose），角色为领域研究员，按 references/workflow-research.md 对 {{SKILL_TOPIC}} 进行详尽研究，并阅读 ~/.agent-skills-spec。若未找到官方文档，技能须在参考文件中标记为“community-sourced”，并警告用户防幻觉护栏较弱，询问是否继续或缩小范围。
- Phase 4：内联执行，不启动子智能体，因为需要用户交互。阅读研究结果，呈现摘要，使用 AskUserQuestion 询问范围问题，询问技能写入位置（个人 ~/.claude/skills/、项目 .claude/skills/ 或自定义路径），产出需求文档，等待用户回答。
- Phase 5：启动编写子智能体，角色为技能作者与规范实现者，按 references/workflow-author.md 在 {{SKILL_PATH}} 创建完整技能。若技能超过 3 个文件，子智能体须将每个文件作为单独任务跟踪。若目标路径已存在则停止并报告，绝不覆盖。
- Phase 6：若 Phase 2 安装失败则跳过；否则调用 Skill("skill-creator") 针对 {{SKILL_PATH}}，验证描述触发是否正确并建议改进。
- Phase 7：启动审查子智能体，角色为质量审计员，按 references/workflow-review.md 审查技能，产出逐条通过/失败及具体修复说明的报告。
- Phase 8：若审查报告包含必需修复，启动精炼子智能体应用修复；最多 2 轮精炼，若仍失败则向用户呈现剩余问题。若审查全部通过则跳过。
- Phase 9：向用户呈现总体通过/失败状态、创建内容（文件树）、精炼中应用的修复、剩余问题，并提供具体后续步骤。
适用场景
- 需要按 Agent Skills Specification 创建新 Agent Skill 时。
- 需要研究支撑、引用文档、工作流模板与防幻觉护栏的技能创建流程时。
- 需要对已有技能创建流程进行审查与精炼时。
限制
- 若无法获取官方文档，技能须标记为 community-sourced，防幻觉护栏较弱。
- 若 Phase 2 安装失败，将跳过 Phase 6，描述不会经过机器测试。
- 若 ~/.agent-skills-spec 完全不存在且无法获取，则无法验证规范符合性。
- 绝不替换已有技能目录，只能新建或向已有目录添加。
- 每个参考文件必须包含消费方智能体被指示遵循的源 URL。
- 脚本须严格遵循 Google Shell Style Guide，见 references/shell-script-standards.md。
- 新创建的技能须按仓库 CLAUDE.md 中“Packaging a skill to .skill”部分打包，运行已安装 skill-creator 插件的打包器，不得自行实现；同时追加 README 页脚并提交 .skill 文件。