asiaostrich/process-automation

流程轉化 Skill 助手

語言: English | 繁體中文

從「我一直在手動做這件事」引導你建立一個合適的 Skill，並在過程中採用恰當深度的開發流程。

使用時機

• 你已手動執行同一組多步驟流程 ≥ 3 次
• 隊友第 3 次問「我們怎麼做 X？」
• 你臨時建了一個 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 核准後回到這裡

廢棄 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 語系 |

工作流程

步驟 1 — 描述流程

記錄重複的步驟序列：

• 哪些步驟？按什麼順序？
• 目前已手動執行幾次？
• 會觸碰哪些工具或檔案？

步驟 2 — 更新 SKILL-CANDIDATES.md

開啟你專案的 SKILL-CANDIDATES.md（第一次使用時從 templates/SKILL-CANDIDATES.md 複製）：

• 尚未記錄 → 新增一行，填入目前次數
• 已記錄 → 更新次數
• 次數達 3 → 標記觸發 ✅，繼續進行

步驟 3 — 選擇路徑（Simple / Complex / Delta）

回答 4 個判斷問題，決定：Simple、Complex 或 Delta。

步驟 4a — Simple：填寫 Skill Brief

使用 templates/SKILL-BRIEF-TEMPLATE.md：

• 觸發情境（什麼時候會用這個？）
• 核心步驟（3~7 個，有序）
• 驗收條件（2~3 條）
• 不涵蓋的部分（明確邊界）

步驟 4b — Complex：建立 XSPEC

執行 /sdd 建立 XSPEC。XSPEC 核准後回到步驟 5。

步驟 4c — Delta：識別變更範圍

識別現有 SKILL.md 中哪些區段需要變更。 在末尾加入 ## MODIFIED Requirements 或 ## ADDED Requirements。

步驟 5 — 建立 / 更新 SKILL.md

從 Brief 或 XSPEC 產生 SKILL.md：

• 驗證 frontmatter：name、scope、description、allowed-tools
• UDS Skill：同時建立 zh-TW 語系版本
• 專案 Skill：放置於 {project}/.claude/skills/{name}/SKILL.md

步驟 6 — 更新 SKILL-CANDIDATES.md

標記候選行：觸發 ✅，Skill 欄位填入名稱。

步驟 7 — Commit

feat(skills): Add /{skill-name} skill. 新增 /{skill-name} Skill。

{English description, 1-2 lines}

{Chinese description, 1-2 lines}

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

輸出檢查清單

完成所有步驟後，驗證：

• [ ] SKILL-CANDIDATES.md 已更新（觸發 ✅，Skill 名稱已填入）
• [ ] SKILL.md 已建立，含完整 frontmatter（name/scope/description/allowed-tools）
• [ ] Simple 路徑：Skill Brief 已被引用或保存
• [ ] Complex 路徑：XSPEC ID 已在 SKILL.md 標頭注釋中標註
• [ ] UDS Skill：zh-TW 語系檔案已建立
• [ ] 廢棄：frontmatter 中含 status: deprecated
• [ ] git commit 已完成

參考

• Skill Brief 模板：templates/SKILL-BRIEF-TEMPLATE.md
• 候選追蹤：templates/SKILL-CANDIDATES.md（複製到你的專案）
• ADR 標準：core/adr-standards.md