skill-builder

name	skill-builder
source	../../../../skills/skill-builder/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-05-28T00:00:00.000Z"
scope	universal
description	[UDS] 識別重複流程並以正確開發深度建立 Skill
allowed-tools	Read, Glob, Grep, Write, Edit, Bash
argument-hint	[流程描述]

流程轉 Skill 助手

語言: English | 繁體中文

引導你從「我一直手動做這件事」走到「擁有一個正確建立的 Skill」，並在過程中保持適量的流程治理。

何時使用

• 你已經用同樣的多步驟流程手動執行 ≥ 3 次
• 同事第 3 次問你「我們是怎麼做 X 的？」
• 你臨時建了一個 Skill，現在想將其正式化

備註：/process-to-skill 是本 Skill 的繁體中文翻譯版，功能完全相同。

核心原則

Skill 紀錄的是流程知識。Memory 紀錄的是歷史事實。 當你注意到自己重複執行相同的步驟，那就是 Skill 候選。

決策樹

需要新建 Skill？
├── 修改現有 Skill？
│     → Delta 路徑：在現有 SKILL.md 後附加 ## MODIFIED / ## ADDED
│                   更新 version 欄位 → 完成
│
├── 回答這 4 個問題（任一「是」→ Complex）：
│     1. 超過 7 個步驟？
│     2. 步驟之間有分支邏輯（if / else）？
│     3. 需要 3+ 不同標準／決策的知識？
│     4. 輸出會直接影響子專案原始碼？
│
├── 全部「否」→ Simple 路徑
│     → 填寫 Skill Brief（templates/SKILL-BRIEF-TEMPLATE.md）
│     → 直接建立 SKILL.md（無需 XSPEC）
│
└── 任一「是」→ Complex 路徑
      → 先建立 XSPEC → 執行 /sdd
      → XSPEC Approved 後回到此處

棄用 Skill？
  → 在 SKILL.md frontmatter 加入：
      status: deprecated
      deprecated_at: YYYY-MM-DD
      deprecated_reason: "..."
      superseded_by: "/new-skill"   (若適用)
  → 在 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

執行 /sdd 建立 XSPEC。XSPEC Approved 後回到 Step 5。

Step 4c — Delta：識別變更範圍