用途
make-skill 用于把可重复的工作流程打包为便携式 Agent Skill。其输出是一个自包含的技能目录，编码智能体可从 SKILL.md 中发现并加载该技能。适用于创建或改进 SKILL.md。
主要能力与使用方式
该技能按阶段推进：
Phase 1：捕获工作流。 对缺失信息进行询问，包括：它做什么（一句话、解决什么问题）、何时触发（确切短语或上下文，要具体）、需要用户提供什么（运行前的输入）、它输出什么（文件变更、代码、聊天输出、命令）、步骤有哪些（从头到尾走一遍流程）、硬性规则有哪些（必须始终做或绝不做的）。如果当前对话已描述某个工作流，应先从中提取答案再提问，不要重复询问已有信息。
Phase 2：编写 Frontmatter。 使用标准 frontmatter 字段，示例如下：
---
name: skill-name # lowercase, hyphenated, no spaces
description: [What it does]. Use when [specific contexts or requests].
license: MIT
---
description 即触发器，Agent 运行时用它决定何时激活技能。要求明确、保持在 200 字符或更少以兼容更多环境：包含技能做什么和何时使用；写出具体上下文或请求类型；优先使用直接的 Use when ... 子句；除非工作流确实依赖某运行时，否则不要在 description 里放运行时特定要求。只使用 Agent Skills 规范定义的字段。仅当技能确有环境或运行时约束时才添加 compatibility。不要在包的 frontmatter 中放入仅目录使用的字段，如 category、tags 或 author。
Phase 3：编写主体。 采用与现有技能质量对齐的结构：
- 开头一行说明（无标题，说明做什么、输出什么）
## Phase N: [标题]用于每个主要部分- 仅当 Phase 1 需要分支（如栈检测、模式选择）时使用
### 1.1子阶段 - 代码块必须包含真实可运行代码，而非伪代码
- 对会静默失败或破坏整个流程的事项使用内联加粗警告
- 结尾使用
## Verify，在代码块内使用裸[ ]项（非 markdown 的- [ ]列表项） - 总长度控制在 500 行以内，长示例移到
references/guide.md
Phase 4：Verify 部分。 验证部分不是可选的，用户用它确认技能是否正确运行。格式固定为：
## Verify
[ ] [技能运行后必须为真的事项] [ ] [输出格式正确] [ ] [边缘情况已处理] [ ] [常见错误已避免]
每一项都必须可核对，没有模糊项如“质量看起来不错”。
Phase 5：参考资料（如需要）。 当完整示例会使 SKILL.md 超过 500 行、多个变体需要各自章节、或边缘情况复杂到需要真实示例时，创建 references/guide.md。参考文件必须包含真实的输入→输出示例，而不是示例大纲。
Phase 6：测试提示词。 写 3–5 个应触发该技能的提示词，以及 2 个不应触发的：
"make a skill for PR reviews" ✅ should trigger
"create a skill to audit my code" ✅ should trigger
"turn this process into a skill" ✅ should trigger
"review my PR" ❌ should not trigger (different skill)
"what skills are available?" ❌ should not trigger
用这些在发布前验证 description。如果应触发的未触发，把该短语加入 description。
Phase 7：打包与校验。 创建一个以技能名精确命名的目录，SKILL.md 放在根目录，可选资源放在 references/、scripts/ 或 assets/。交付前：解析 YAML frontmatter 并确认 name 与目录名一致；确认 description 说明做什么与何时使用且在 200 字符或更少；检查每个相对 Markdown 链接在技能目录内可解析；确认每个打包的参考文件都直接从 SKILL.md 链接并说明何时读取；存在仓库技能校验器时运行它；交付完整目录而非仅 SKILL.md，以便安装时保留打包资源。
验证清单
[ ] YAML frontmatter 仅使用标准字段且包含 name、description、license
[ ] Name 与小写连字符目录名一致
[ ] Description 说明做什么与何时使用且在 200 字符或更少
[ ] 主体以一行说明开头——其前无标题
[ ] 所有部分使用 ## Phase N: Title 格式
[ ] 代码块包含真实代码而非伪代码
[ ] 关键约束已内联加粗
[ ] Verify 部分在围栏代码块中使用裸 [ ] 项
[ ] SKILL.md 少于 500 行
[ ] 必要时长示例已移到 references/guide.md 并从 SKILL.md 链接
[ ] 每个相对链接可解析且每个打包参考文件可访问
[ ] 已写 3-5 个测试提示词用于验证触发器
另见 references/guide.md，其中包含带注释的便携式技能、多文件示例和常见结构错误。