skill-builder

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。