skills

1. 專案概覽

Skills（由 Matt Pocock 開發）是一個開源的 AI 代理「技能」集合——這些技能是可重複使用、可組合的指令集，教導 Claude Code 和 Codex 等程式碼代理嚴謹且貼近真實世界的軟體工程實務，而非快速但不可靠的程式碼生成。

2. 背景與定位

Skills 的誕生是為了解決開發者在使用 AI 程式碼代理時常遇到的四種重複性失敗模式：

1. 開發者意圖與代理輸出之間的落差——透過結構化的訪談技能（如 grill-me 和 grill-with-docs）來緩解。
2. 代理的冗長輸出掩蓋了專案清晰度——透過共享的領域語言和 CONTEXT.md 慣例來解決，讓代理始終貼近專案術語。
3. 回饋迴圈薄弱導致的損壞程式碼——透過測試驅動開發（tdd）和結構化除錯（diagnosing-bugs）來處理。
4. 在快速、代理驅動的開發下產生的架構劣化——透過設計導向的技能（如 improve-codebase-architecture）來預防。

與大型、一體適用的「代理框架」專案不同，Skills 刻意保持小巧且不帶強烈意見：每個技能都是一個獨立、可編輯的 Markdown 檔案，而非單一系統的一部分。這使得整個集合易於閱讀、調整、複製或精簡，團隊可以只取所需，而不必採用整套規定式工作流程。

3. 功能分類

🛠️ 工程技能——使用者觸發（8 個技能）：由開發者明確觸發以編排工作流程。

• ask-matt — 路由器，協助你找到適合任務的技能
• grill-with-docs — 建立專案領域模型的訪談工作階段
• triage — 管理並排定問題狀態的優先順序
• improve-codebase-architecture — 發掘並提出架構改進建議
• implement — 內建 TDD 的功能建置
  目的：為常見的高階工程工作流程提供明確的進入點。

🤖 工程技能——模型觸發（8 個技能）：代理在任務期間自行決定何時套用。

• tdd — 強制執行測試驅動開發迴圈
• diagnosing-bugs — 結構化、假設驅動的除錯方法論
• research — 要求引用來源的調查工作流程
• domain-modeling — 強化並維持一致的專案術語
• code-review — 套用雙軸（正確性 + 規格遵循）審查標準
  目的：將工程紀律直接內建到代理的預設行為中，無需開發者另行要求。

📈 生產力技能——使用者觸發（4 個技能）：開發者觸發的工作流程輔助工具。

• grill-me — 大型任務前的詳盡規劃訪談
• handoff — 產生對話摘要，以便將工作移交給另一個代理工作階段
• teach — 多工作階段的技能教學，用於入門引導
• writing-great-skills — 編寫新技能的參考指南
  目的：簡化規劃、入門引導以及工作階段之間的連續性。

🔁 生產力技能——模型觸發（1 個技能）：背景工作流程支援。

• grilling — 可重複使用的訪談迴圈，供其他技能呼叫
  目的：提供一個共享的建構區塊，供其他訪談式技能呼叫。

4. 重點特色

• 天生可組合——每個技能都是一個小型、獨立的 SKILL.md 檔案，團隊可以只採用所需部分，並自由編輯其餘內容。
• 雙重觸發模型——技能分為使用者觸發（你明確要求）和模型觸發（代理自動套用），可精細控制代理行為。
• 內建 TDD 紀律——tdd 和 implement 技能促使代理在撰寫程式碼前先寫測試，直接針對「回饋迴圈薄弱導致損壞程式碼」的失敗模式。
• 結構化除錯勝於猜測——diagnosing-bugs 和 research 要求代理形成假設並引用來源，而非隨意發揮。
• 領域語言扎根——CONTEXT.md 和 domain-modeling 讓代理使用專案實際術語，而非泛泛之詞。
• 多種安裝路徑——可作為受管理、自動更新的 Claude Code 外掛，或透過 npx skills 安裝為可編輯檔案，適用於 Codex 及其他代理。

5. 依角色分類的使用案例

• 一般開發者：使用 grill-me 和 implement 將模糊的功能需求轉化為範圍明確、有測試覆蓋的實作，並用 handoff 在不同工作階段間接續工作。
• 專案/技術負責人：使用 improve-codebase-architecture 和 code-review，在代理貢獻更多程式碼時維持架構與審查標準的一致性。
• 將 AI 代理導入程式碼庫的團隊：使用 setup-matt-pocock-skills、CONTEXT.md 和 domain-modeling，讓代理從第一天起就擁有共享詞彙，減少輸出不一致。

6. 開始使用

找到你需要的技能——瀏覽儲存庫中的技能目錄與分類，或在代理工作階段中詢問路由器技能：

/ask-matt

安裝／整合：

# Claude Code 外掛（受管理、自動更新）
claude plugins install mattpocock-skills
# 或在 Claude Code 工作階段中：
/plugin install mattpocock-skills

# Codex 及其他代理（可編輯的本地檔案）
npx skills@latest add mattpocock/skills

# 每個儲存庫的一次性設定
/setup-matt-pocock-skills

貢獻——這些技能刻意保持小巧且易於調整；分叉儲存庫、編輯或新增 SKILL.md，並依照 writing-great-skills 中的指引開啟拉取請求。

7. 專案結構

skills/
├── .agents/            # 代理設定檔
├── .claude-plugin/      # Claude Code 外掛設定
├── .github/workflows/   # CI 工作流程
├── docs/                # 文件
├── scripts/             # 建置與工具腳本
├── skills/
│   ├── engineering/     # 程式碼導向技能（tdd、code-review 等）
│   └── productivity/    # 一般工作流程技能（grill-me、handoff 等）
├── AGENTS.md            # 代理導向文件
├── CLAUDE.md            # Claude 專用設定說明
├── CONTEXT.md           # 專案領域模型與術語
└── LICENSE              # MIT 授權

每個技能都位於自己的目錄中，並附有專屬的 SKILL.md 描述其使用時機與方式，讓整個集合易於瀏覽和擴充。

8. 相關生態系

• 依賴項目：Claude Code（Anthropic 的程式碼代理 CLI）和 Codex，這兩個是這些技能設計的主要代理執行環境；skills npm 套件／CLI（npx skills）用於安裝與更新。
• 互補工具：任何支援自訂技能／外掛載入的 Markdown 驅動代理，原則上都能使用這些技能檔案，因為每個 SKILL.md 都是獨立的指令集。

9. 授權

✅ 可將程式碼用於個人或商業專案（依 MIT 授權允許）。
✅ 可分叉儲存庫並調整個別技能以符合團隊工作流程。
❌ 不得在重新發布的副本中移除原始版權與授權聲明。
ℹ️ MIT 授權以「現況」提供軟體，不附帶任何保證——生產使用前請詳閱儲存庫中的 LICENSE 檔案以了解完整條款。

10. 常見問題

問：使用這些技能需要 Claude Code 嗎？
答：不需要——Claude Code 使用者可透過外掛市集安裝，而 Codex 及其他代理使用者可透過 npx skills@latest add mattpocock/skills 安裝可編輯檔案。

問：如何保持技能更新？
答：Claude Code 外掛會自動更新；手動安裝的檔案則執行 npx skills update。

問：使用者觸發和模型觸發的技能有何不同？
答：使用者觸發的技能由你明確觸發（例如 /grill-me），而模型觸發的技能（例如 tdd、diagnosing-bugs）則由代理在相關時自動套用。

問：我可以編寫自己的技能嗎？
答：可以——請參閱儲存庫中的 writing-great-skills 技能以了解編寫指南與慣例。

問：安裝後需要執行設定步驟嗎？
答：需要——每個儲存庫執行一次 /setup-matt-pocock-skills，以設定問題追蹤、分流標籤和文件位置。

11. 快速連結

• 儲存庫：https://github.com/mattpocock/skills
• 授權：https://github.com/mattpocock/skills/blob/main/LICENSE
• 問題回報：https://github.com/mattpocock/skills/issues
• 討論／社群：透過儲存庫的 Issues 和 Pull Requests

12. 總結

Skills 為團隊提供一個輕量、可編輯的工具包，讓 AI 程式碼代理表現得更像嚴謹的工程師——在編碼前規劃、在發布前測試，並扎根於專案真實的領域語言。它最適合已經依賴 Claude Code 或 Codex 的開發者與技術負責人，他們希望在無需採用重量級框架的情況下，獲得一致且可審查的輸出。