指令用途

/setup-matt-pocock-skills 是整個 engineering skills 系統的一次性設定。它會回答關於一個 repo 的三個問題 —— issues 放哪、triage labels 叫什麼、domain docs 放哪 —— 並把答案以 markdown 檔案記錄到 docs/agents/ 之下。

那些檔案是 repo 之間唯一會變動的部分。skills 本身在每個地方都完全相同；它們在執行時讀取 docs/agents/issue-tracker.md 並照其指示行事。這就是為什麼這套 skills 不綁定 GitHub，也沒有任何 skill 檔案需要編輯才能指向別處。

它是一個 prompt 驅動的 skill，而非確定性的腳本。它會讀取你的 git remote、你既有的 CLAUDE.md、你既有的 CONTEXT.md，提出它找到的內容，然後等你確認後才寫入任何東西。

運作流程

1. 探索：讀取 git remote、CLAUDE.md/AGENTS.md、CONTEXT.md、docs/adr/、docs/agents/、.scratch/，理解 repo 的起始狀態。
2. 三個決策：針對 issue tracker、triage labels（僅當 triage 已安裝）、domain docs 提出建議答案並等待確認。
3. 寫入：把 docs/agents/*.md 與 CLAUDE.md/AGENTS.md 中的 ## Agent skills 區塊寫入。
4. 完成：告知設定完成，並說明哪些 engineering skills 會從這些檔案讀取。

三個決策

它會在每個區塊以建議答案開頭，並跳過任何探索已經敲定的部分。大多數的執行是兩次確認就完成。

實戰對話範例

範例一：GitHub repo 初次設定

• You:

  /setup-matt-pocock-skills

• AI:

  我讀過你的 git remote，這是一個 GitHub repo。我建議使用 GitHub Issues 作為 issue tracker。

  這裡會寫入：

  • docs/agents/issue-tracker.md —— issue tracker 設定
  • docs/agents/domain.md —— domain docs 消費規則
  • CLAUDE.md 的 ## Agent skills 區塊

  確認使用 GitHub Issues 嗎？

範例二：有安裝 triage 的 repo

• You:

  /setup-matt-pocock-skills

• AI:

  我偵測到 triage skill 已安裝，所以也會寫入 docs/agents/triage-labels.md。

  建議保留五個標準 triage labels：

  • needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix

  保留預設的 triage labels 嗎？

它寫入的位置

全部都是提交版控的 markdown。沒有使用者層級或全域模式：設定就活在 repo 裡，所以每個 repo 都有自己的副本。

何時應該（重新）使用

• 新 repo 首次設定：在使用任何其他 engineering skill 之前，務必先執行一次。
• 切換 issue tracker：例如從 GitHub 換到 GitLab，或改用 local-markdown。
• 從零重來：想完全重新開始時。

一般編輯 docs/agents/*.md 不需要重跑 —— 你隨時可以直接改那些檔案。

與其他技能的關係

setup-matt-pocock-skills 是 engineering 流程的一次性前置設定，是其他所有技能所假設的前提，而不是流程鏈中的一個步驟。它的鄰居是它的讀者：

• triage 套用這裡寫下的 label 詞彙
• to-spec 與 to-tickets 發佈到這裡命名的 tracker
• wayfinder 讀取同一個 tracker 檔案的「Wayfinding operations」區塊
• domain-modeling 填補這裡記錄的 domain docs 版面（CONTEXT.md 與 ADRs）