Skip to content
Skills Library
AI & agents · Building & coding

skill-builder

/skill-builder

[UDS] 把重複的手動流程轉成範圍界定得宜的 Skill,過程中拿捏恰當的流程份量。 Use when: 同一段多步驟流程已經手動做過三次以上、把臨時湊出來的 Skill 正式化、決定某個 Skill 該放在哪一層。 Not for: 記錄歷史事實或專案狀態——那屬於記憶,不是 Skill;不會再發生的一次性任務。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化, 重複流程.

Licence
MIT
Last repository change
08.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
4
Deprecation

No signals detected. Repository changed on 08.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

[UDS] 把重複的手動流程轉成範圍界定得宜的 Skill,過程中拿捏恰當的流程份量。 Use when: 同一段多步驟流程已經手動做過三次以上、把臨時湊出來的 Skill 正式化、決定某個 Skill 該放在哪一層。 Not for: 記錄歷史事實或專案狀態——那屬於記憶,不是 Skill;不會再發生的一次性任務。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化, 重複流程.

Arguments

/skill-builder [process description | 流程描述]
Original author description

[UDS] 把重複的手動流程轉成範圍界定得宜的 Skill,過程中拿捏恰當的流程份量。 Use when: 同一段多步驟流程已經手動做過三次以上、把臨時湊出來的 Skill 正式化、決定某個 Skill 該放在哪一層。 Not for: 記錄歷史事實或專案狀態——那屬於記憶,不是 Skill;不會再發生的一次性任務。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化, 重複流程.

How it works

  1. 何時使用
  2. 核心原則
  3. 決策樹
  4. 擺放位置決策
  5. 工作流程
  6. 輸出檢查清單
  7. 參考
Original SKILL.md headings · 136 lines, 400 words
SKILL.md preview
---
name: skill-builder
source: ../../../../skills/skill-builder/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-10-12
source_hash: 8eee581c49c4
scope: universal
description: |
  [UDS] 把重複的手動流程轉成範圍界定得宜的 Skill,過程中拿捏恰當的流程份量。
  Use when: 同一段多步驟流程已經手動做過三次以上、把臨時湊出來的 Skill 正式化、決定某個 Skill 該放在哪一層。
  Not for: 記錄歷史事實或專案狀態——那屬於記憶,不是 Skill;不會再發生的一次性任務。
  Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化, 重複流程.
allowed-tools: Read, Glob, Grep, Write, Edit, Bash
argument-hint: "[process description | 流程描述]"
---

# 流程轉 Skill 助手

> **語言**: [English](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/skill-builder/SKILL.md) | 繁體中文

引導你從「我一直手動做這件事」走到「擁有一個正確建立的 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 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:識別變更範圍

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

### Step 5 — 建立 / 更新 SKILL.md

依 Brief 或 XSPEC 生成 SKILL.md:
- 確認 frontmatter:`name`、`scope`、`description`、`allowed-tools`
- UDS Skill:同步建立 zh-TW locale 版本
- 專案 Skill:放在 `{project}/.claude/skills/{name}/SKILL.md`

### Step 6 — 更新 SKILL-CANDIDATES.md

將候選列標記為:trigger ✅、Skill 欄位填寫完成。

### Step 7 — Commit

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

{English description, 1-2 lines}

{中文描述,1-2 行}

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
```

## 輸出檢查清單

完成所有步驟後,請確認:

- [ ] `SKILL-CANDIDATES.md` 已更新(trigger ✅、Skill 名稱已填)
- [ ] `SKILL.md` 已建立並有完整 frontmatter(`name` / `scope` / `description` / `allowed-tools`)
- [ ] Simple 路徑:Skill Brief 已引用或保留
- [ ] Complex 路徑:XSPEC ID 已記錄在 SKILL.md header comment
- [ ] UDS skill:已建立 zh-TW locale 檔案
- [ ] 棄用:frontmatter 含 `status: deprecated`
- [ ] git commit 已完成

## 參考

- Skill Brief 模板:[templates/SKILL-BRIEF-TEMPLATE.md](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/templates/SKILL-BRIEF-TEMPLATE.md)
- 候選追蹤:[templates/SKILL-CANDIDATES.md](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/templates/SKILL-CANDIDATES.md)(請複製到專案)
- ADR 標準:[core/adr-standards.md](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/core/adr-standards.md)

Versions

RepositoryScoreLicence
This page · AsiaOstrich/universal-dev-standards100MIT
x85446/claudecodetricks100MIT
boshu2/agentops100Apache-2.0
dreamlab-ai/agentbox100AGPL-3.0
AsiaOstrich/universal-dev-standards100MIT
AsiaOstrich/universal-dev-standards100MIT
AsiaOstrich/universal-dev-standards100MIT
amazon-quick/amazon-quick-official-catalog100MIT
agentflocks/flocks100Apache-2.0

Database snapshot: 13.11.2026 · package version 5ba43a6964d6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100bm-skill-builder
    Build a new agent skill (or restructure an existing one) following Builder Methods conventions. Use when the user wants to create a skill, turn a repeatable process into a skill, or restructure a skill that has outgrown its shape — "create a skill", "make this a skill", "turn my…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.