Skill Creation Workflow

--- name: skill-creation-workflow description: "创建、修改、审计或规范 AI agent 技能时必须使用本技能。它强制先用 brainstorming 与用户确认技能目标、触发场景、输出格式和测试策略，用户确认后才允许生成或修改技能文件；随后必须使用 skill-creator 完成技能创建、修改、评估或审计。所有新建或修改的技能必须包含中文强约束，要求技能说明、交互说明、生成文档、测试记录和产物说明默认使用中文。适用于用户要求创建新技能、改进已有技能、审计技能质量、补充 eval、规范技能产物路径、把某个工作流沉淀为技能，或要求检查技能是否符合仓库规范的场景。"

Skill Creation Workflow

本技能用于规范“创建、修改和审计技能”的流程。它是一个流程守门技能：先确认需求，再调用专门的技能创建能力，最后检查产物是否符合仓库约定和中文约束。

1. 必须使用 brainstorming 确认细节。 在创建或修改任何技能文件之前，先用 brainstorming 与用户确认：技能目标、触发场景、期望输出、是否需要 eval、技能目录名、中文约束范围。

2. 必须等待用户确认。 用户明确确认设计之前，不要创建、修改、删除或覆盖 skills/<技能名>/ 下的任何技能源码文件。

3. 必须使用 skill-creator 执行技能工作。 用户确认后，使用 skill-creator 创建、修改、评估或审计技能。不要用临时个人习惯替代 skill-creator 的流程。

4. 必须加入中文强约束。 新建或修改的技能必须包含一条清晰的中文强约束，并优先写入目标技能的 <HARD-GATE>。如果目标技能还没有 <HARD-GATE>，新增一个。该约束要求技能说明、与用户的交互、生成的文档、测试记录、产物说明和审计结论默认使用中文。代码、文件路径、命令、API 名、技术名词和用户指定必须保留原文的内容可以使用英文。

5. 只能维护 skills/ 下的技能源码。 技能源码只写入 skills/<技能名>/。不要在 .agents/、.claude/、.codex/skills/、.cursor/skills/、.trae/skills/ 或其他 agent 专属目录中创建第二份技能源码。

触发后流程

1. 探查上下文

• 查看 skills/ 下已有技能，避免命名和职责重复。
• 如果是修改或审计已有技能，先读取 skills/<技能名>/SKILL.md。
• 如果用户询问使用方式且 USAGE.md 存在，同时读取 skills/<技能名>/USAGE.md。
• 如果存在 skills/<技能名>/evals/，检查已有 eval 是否覆盖本次变更。

2. 使用 brainstorming 确认需求

在进入实现前，至少确认以下内容：

• 技能名称和目录名。
• 技能要让 agent 做什么。
• 哪些用户表达、上下文或任务类型应该触发该技能。
• 技能的输出格式或交付物。
• 是否需要 USAGE.md。
• 是否需要 evals/evals.json，以及 eval 应覆盖哪些关键行为。
• 中文强约束的覆盖范围。

确认可以很短，但必须明确。不要把“我理解了”视为用户确认；需要用户明确表示同意、确认、可以开始或等价表达。

3. 使用 skill-creator 创建或修改

用户确认后，按 skill-creator 的方式执行：

• 新建技能时，创建 skills/<技能名>/SKILL.md。
• SKILL.md frontmatter 至少包含 name 和 description。
• 目录名使用小写英文和连字符。
• 推荐创建 USAGE.md，用于面向人的快速说明。
• 如果技能行为可以通过 prompt 测试，创建或更新 evals/evals.json。
• 修改已有技能时，保留目录名和 frontmatter 中的 name 字段，除非用户明确要求重命名。

4. 写入中文强约束

每个新建或修改的技能都必须把中文强约束放入 <HARD-GATE> 或等价硬门禁。可以根据技能领域调整措辞：

## 中文输出约束

除非用户明确要求使用其他语言，所有与用户的交互、技能说明、生成的文档、测试记录、审计结论和产物说明都必须使用中文。代码、文件路径、命令、API 名、技术术语、第三方库名和用户提供的原文内容可以保留英文。

如果技能会生成文件，还要说明生成文件中的标题、标签、说明文字和报告内容也默认使用中文。

5. 审计技能

审计技能时，检查以下项目：

• SKILL.md 是否存在。
• frontmatter 是否包含 name 和 description。
• description 是否清楚说明触发场景，而不是只描述技能是什么。
• 是否有中文强约束，且该约束是否位于 <HARD-GATE> 或等价硬门禁中。
• 是否要求在关键行动前获得用户确认。
• 是否把一次性项目经历写进了 SKILL.md。
• 大型参考资料、脚本、模板或示例是否放在辅助文件中。
• 可测试行为是否有 evals/evals.json。
• 运行产物是否会写入 outputs/<技能名>/ 或用户指定位置，而不是混入技能源码目录。

输出位置

遵守本仓库约定：

完成前检查

结束前确认：

• 已先使用 brainstorming 并获得用户确认。
• 已使用 skill-creator 完成创建、修改或审计。
• 技能源码位于 skills/<技能名>/。
• SKILL.md 包含有效 frontmatter。
• description 覆盖触发场景。
• 技能包含中文强约束，且优先位于 <HARD-GATE>。
• 如适用，已创建或更新 USAGE.md。
• 如适用，已创建或更新 evals/evals.json。
• 没有在 agent 专属目录创建第二份技能源码。