mp-setup-matt-pocock-skills

name	mp-setup-matt-pocock-skills
description	建立 MP 工作入口層的專案規則。Use when: 首次導入 mattpocock/skills 改寫版、 需要設定 docs/agents/、需要讓 Claude Code 與 Codex 共同讀取 issue tracker、 triage states、domain docs 規則，或 mp-* 技能缺少專案入口脈絡。

mp-setup-matt-pocock-skills

本技能用來建立儲存庫層級的 MP 工作入口規則。它不是用來執行功能實作，也不是用來取代 openspec-* 或 superpowers:*。

使用前提

• 先讀取並遵守 auto-skill。
• 先檢查現有檔案，不可直接覆寫使用者內容。
• 若同時存在 CLAUDE.md 與 AGENTS.md，兩者都要更新，但只放入口提示。
• 共同規則一律放在 docs/agents/。

探查

開始前先讀取：

• git remote -v
• CLAUDE.md
• AGENTS.md
• docs/agents/
• CONTEXT.md
• CONTEXT-MAP.md
• docs/adr/
• openspec/
• .scratch/

輸出你看到的現況：已存在、缺少、可能衝突。

三個決策

一次只問一個決策問題。每個問題都要附上你的建議與理由。

1. 工作項目出口

先判斷此儲存庫實際追蹤工作的地方。

預設建議順序：

1. 若正在處理正式變更，優先使用 OpenSpec tasks.md。
2. 若使用者明確要 GitHub issue，輸出 GitHub issue draft。
3. 若沒有外部 tracker，輸出本地 Markdown。

記錄到 docs/agents/issue-tracker.md。

2. 任務分流狀態

MP 使用固定狀態模型，不綁定外部 label：

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

若外部系統有既有 label，只在文件中記錄 mapping，不改變 canonical state 名稱。

記錄到 docs/agents/triage-states.md。

3. 專案語言與決策文件

確認此儲存庫是 single-context 還是 multi-context：

• single-context：根目錄 CONTEXT.md，決策在 docs/adr/。
• multi-context：根目錄 CONTEXT-MAP.md 指向各子 context。

檔案採 lazy creation。只有在真的沉澱術語或 ADR 時才建立 CONTEXT.md 或 docs/adr/。

記錄到 docs/agents/domain.md。

寫入規則

必須建立或更新：

• docs/agents/issue-tracker.md
• docs/agents/triage-states.md
• docs/agents/domain.md
• docs/agents/mp-workflow.md

若 CLAUDE.md 存在，加入或更新「MP 工作入口層」區塊。若 AGENTS.md 存在，也做同樣更新。

入口區塊只應包含：

• MP 工作入口層是什麼。
• 何時使用 mp-*。
• 共同規則位於 docs/agents/。
• openspec-* 與 superpowers:* 仍保留原職責。

不得在 CLAUDE.md 與 AGENTS.md 各自維護不同版本的詳細規則。

完成條件

• docs/agents/ 四份文件存在。
• CLAUDE.md 與 AGENTS.md 若存在，都指向 docs/agents/。
• 沒有直接安裝或複製整包上游 mattpocock/skills。
• 沒有覆寫 openspec-* 或 superpowers:*。