create-skill

用途：创建或重构 Claude Code 技能（skill），适合在新建技能或调整现有技能结构时使用；技能质量审计不在其范围内（应使用 skill-health-check）。触发关键词包括 create skill、new skill、build skill、refactor skill、update skill、restructure skill。\n\n主要能力与工作流：分五个阶段。阶段一确认目标，明确是新建还是重构、技能名称（kebab-case）、一句话用途、触发关键词。阶段二选择载体，依据场景区分 CLAUDE.md（全局、始终需要、稳定规则）、Skill（按需、领域知识、工作流）、Hook（每次都执行、零例外，如 lint 或阻断）、Subagent（大量读文件、隔离上下文）。阶段三设计结构，目录为 skills/{name}/，含 SKILL.md（触发时加载的工作流）、references/（按需读取的知识库）、scripts/（确定性可执行脚本）。阶段四编写 SKILL.md，包括 frontmatter（name、description、allowed-tools、context）、何时使用/不使用、逐步工作流、验证方法、2-5 个示例。阶段五验证，做触发测试、流程测试、边界测试。\n\n用法：按 SKILL.md 模板编写，frontmatter 字段中 name 为 kebab-case 唯一标识（必填），description 为含关键词的触发描述（必填），allowed-tools 限制可用工具（默认全部），context 可选 fork（隔离）或 none（共享，默认共享），agent 可指定 Explore、Plan 等（默认无），disable-model-invocation 阻止模型自动触发（默认 false），user-invocable 控制是否出现在 / 菜单（默认 true）。重构时先阅读现有 SKILL.md，识别过长、触发不准、缺少验证等问题，参考 references/skill-design-guide.md，简化内容并把细节移入 references，再测试触发词是否仍生效。设计检查项包括描述清晰、SKILL.md 简洁、脆弱流程加保护（deploy/commit 用 disable-model-invocation）、机械步骤用脚本并在 SKILL.md 记录 I/O 契约、硬性规则用 Hook、具备验证方法。相关技能有 doc-review、tech-spec、feature-dev。具体命令与完整示例资料未提供。