| name | skill-builder |
| source | ../../../../skills/skill-builder/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-07-16T00:00:00.000Z" |
| source_hash | 1c5f079e0851 |
| status | current |
| scope | universal |
| description | [UDS] 识别重复流程并以正确的开发深度构建 Skill
|
| allowed-tools | Read, Glob, Grep, Write, Edit, Bash |
| argument-hint | [process description | 流程描述] |
流程转 Skill 助手
语言: English | 简体中文
引导你从「我一直在手动做这件事」走到「拥有一个正确构建的 Skill」，并在这一过程中保持适量的流程治理。
何时使用
- 你已经用同样的多步骤流程手动执行 ≥ 3 次
- 同事第 3 次问你「我们是怎么做 X 的？」
- 你临时建了一个 Skill，现在想把它正式化
核心原则
Skill 记录的是流程知识。Memory 记录的是历史事实。
当你注意到自己重复执行相同的步骤时，那就是一个 Skill 候选。
决策树
New Skill needed?
├── Modifying existing Skill?
│ → Delta path: append ## MODIFIED / ## ADDED to existing SKILL.md
│ update version field → done
│
├── Answer these 4 questions (any "yes" → Complex):
│ 1. More than 7 steps?
│ 2. Branching logic between steps (if/else)?
│ 3. Requires knowledge from 3+ separate standards/decisions?
│ 4. Output directly affects sub-project source code?
│
├── All "no" → Simple path
│ → Fill Skill Brief (templates/SKILL-BRIEF-TEMPLATE.md)
│ → Create SKILL.md directly (no XSPEC needed)
│
└── Any "yes" → Complex path
→ Create XSPEC first → run /sdd
→ Return here after XSPEC Approved
Deprecating a Skill?
→ Add to SKILL.md frontmatter:
status: deprecated
deprecated_at: YYYY-MM-DD
deprecated_reason: "..."
superseded_by: "/new-skill" (if applicable)
→ Mark archived in SKILL-CANDIDATES.md
摆放位置决策
在创建 SKILL.md 前，先决定它应该放在哪里：
| 条件 | 摆放位置 |
|---|
| 步骤引用项目特定路径（如 TECH-RADAR.md、DEC-*.md） | 项目：{project}/.claude/skills/ |
| 步骤为通用流程（无项目特定路径） | UDS：skills/{name}/ + zh-TW locale |
工作流程
Step 1 — 描述流程
捕捉重复的步骤序列：
- 哪些步骤？按什么顺序？
- 目前手动执行过几次？
- 触及哪些工具或文件？
Step 2 — 更新 SKILL-CANDIDATES.md
打开你项目的 SKILL-CANDIDATES.md（首次请从 templates/SKILL-CANDIDATES.md 复制）：
- 尚未记录 → 新增一行，填入当前次数
- 已记录 → 增加次数
- 次数达到 3 → 标记 trigger ✅，继续执行
Step 3 — 选择路径（Simple / Complex / Delta）
回答这 4 个判断问题。确定：Simple、Complex 或 Delta。
Step 4a — Simple：填写 Skill Brief
使用 templates/SKILL-BRIEF-TEMPLATE.md：
- 触发情境（何时会用到？）
- 核心步骤（3 ~ 7 个，有顺序）
- 验收条件（2 ~ 3 条）
- 范围外（明确边界）
Step 4b — Complex：创建 XSPEC
执行 创建 XSPEC。XSPEC Approved 之后回到 Step 5。
