# Skill Creation Workflow

> ---

- Skill: `xiao0916/skill-creation-workflow` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add xiao0916/skill-creation-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiao0916/skill-creation-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: xiao0916 (https://skillmd.com/u/xiao0916)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiao0916/skill-creation-workflow

---

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

# Skill Creation Workflow

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

<HARD-GATE>
以下规则不可违反：

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 专属目录中创建第二份技能源码。

</HARD-GATE>

## 触发后流程

### 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>` 或等价硬门禁。可以根据技能领域调整措辞：

```markdown
## 中文输出约束

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

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

### 5. 审计技能

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

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

## 输出位置

遵守本仓库约定：

| 内容 | 默认位置 |
|---|---|
| 技能源码 | `skills/<技能名>/` |
| 技能说明 | `skills/<技能名>/SKILL.md` |
| 面向人的使用说明 | `skills/<技能名>/USAGE.md` |
| 可复用 eval | `skills/<技能名>/evals/` |
| 测试记录 | `test-results/<技能名>/` |
| 技能运行产物 | `outputs/<技能名>/` |

## 完成前检查

结束前确认：

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