Playbook DOC—SKILLS.FLOW/01 REV 2026.04 · a
— The Agent Skills Playbook —

Agent Skills/工程工作流圖

Compiled by 2026·04·22 21 SKILLS · ACTIVE
figure 00 · thesis 21 Skills,
6 Stages.
Agent Skills 是給 AI coding agent 使用的 工程工作流集合——把資深工程師在開發每個階段的做事方法編碼下來, 讓 agent 在定義、規劃、實作、驗證、審查、交付各階段都遵守一致的品質門檻。 這張圖把 21 個 skill 依開發生命週期排列,方便你找到「現在該用哪個」。

Legend · 圖例

  • Structural Frame
  • Primary Flow
  • When to Use
  • Core Principle
Pipeline · 六階段開發生命週期 19 Stage Skills + 2 Meta · total 21
01
Define
定義

把模糊想法寫成結構化 spec——要做什麼、為什麼、怎樣算完成。

02
Plan
規劃

把工作拆成小而可驗證的 task,每個都能在一個 session 裡完成。

03
Build
實作

薄切片推進——每一塊都留下可運作、可測試的系統狀態。

04
Verify
驗證

用真實 runtime 資料驗證;壞掉時照 triage 找根因,不靠猜。

05
Review
審查

Merge 前五維把關:正確性、可讀性、架構、安全、效能。

06
Ship
交付

Git、CI、docs、launch 到位——部署要可逆、可觀測、漸進。

01/06
— Meta Skills
後設技能 · 入口與發想
所有 skill 的入口。前者幫 agent 找出並啟用合適的 skill, 後者在想法還沒成形時,用結構化的發散收斂把粗略念頭打磨成值得動手的具體概念。
// entry-point
02/06
— Define & Plan
先講清楚 · 再拆小塊
在寫任何 code 之前,先寫 spec、再把工作拆成小而可驗證的 task。 這兩步決定後續所有實作是「可靠交付」還是「寫出一團糟」。
// contract-first
03/06
— Build
實作紀律 · 一次一塊
實作階段的六項紀律:切薄、先測試、管理 context、靠官方文件、 UI 要像人做的、介面要難以誤用。一次把一小塊做對,才是可管理的交付節奏。
// /build
S05 · BUILD

incremental-implementation

incremental-implementation

以「薄的垂直切片」一次做一小塊,每塊都留下可運作、可測試的系統狀態。

牽動多檔的功能;準備一次寫大量程式碼;任務感覺一步到位太大時。
避免一次寫完再測試——這是讓大型功能變可管理的執行紀律。
S06 · BUILD

test-driven-development

test-driven-development

寫實作前先寫會失敗的測試;修 bug 前先用測試重現 bug。

實作任何邏輯、修任何 bug、改變任何行為時。
測試是證明,「看起來對」不算完成。有好測試的 codebase 是 agent 的超能力,沒測試就是負債。
S07 · BUILD

context-engineering

context-engineering

刻意設計 agent 能看見什麼資訊、何時看見、以什麼結構看見。

啟動新 session;輸出品質下滑;切換任務;需要設定 rule files 時。
Context 是 agent 輸出品質最大的槓桿——太少會幻覺,太多會失焦。
S08 · BUILD

source-driven-development

source-driven-development

所有 framework 相關決策都要用官方文件支撐,避免憑記憶寫 code。

用任何 framework 或 library,且正確性很重要時。
訓練資料會過期、API 會被棄用、最佳實踐會演進——引用權威來源,讓人能信任也能查證。
S09 · BUILD

frontend-ui-engineering

frontend-ui-engineering

打造可存取、效能好、視覺精緻的 production 等級 UI。

建構或修改面向使用者的介面;寫 component、layout、狀態管理時。
真正符合 design system、注重 accessibility、互動細節考究——避免千篇一律的「AI 美學」。
S10 · BUILD

api-and-interface-design

api-and-interface-design

設計穩定、文件良好、難以誤用的 API 與介面。

設計 API、module 邊界、REST/GraphQL endpoint、前後端合約時。
好的介面讓「對的事情變容易、錯的事情變困難」。
04/06
— Verify
驗證現場 · 不靠猜測
出錯不靠靜態分析猜,而是用真實 runtime 資料驗證;壞掉不亂改, 而是照 triage 流程找根因。兩個 skill 互補,形成「能驗、能修」的回路。
// /test
05/06
— Review
審查閘門 · 五維把關
Merge 之前的最後一道關卡。正確性、可讀性、架構、安全、效能—— 五個面向每次都要過,沒有例外。另外兩個 skill 聚焦於「簡化」與「安全強化」。
// /review
06/06
— Ship
交付紀律 · 可逆可觀測
在 AI agent 快速生成程式碼的時代,交付要能被管理、被審查、被回復。 Git 是存檔點、CI/CD 是執行保險、deprecation 是對抗負債、文件記錄決策、launch 要漸進可逆。
// /ship
— The Result —

流程 × 紀律 × 品質

PROCESS · 01

流程一致

從 spec 到 ship 都有對應 skill,每個階段都能照同一套標準辦事,不再每次重新想流程。

×
DISCIPLINE · 02

紀律內建

TDD、incremental、review gate、可觀測部署——資深工程師的做事方法被編碼成 agent 的預設行為。

×
QUALITY · 03

品質可驗

測試即證明、context 即品質、部署即可逆——每一步都留下可追溯、可驗證的證據鏈。

Further Reading 延伸閱讀