Setup Anping Skills 項目啟動器
把當前倉庫初始化成適合 Codex 長期協作的項目環境。這個 Skill 是 prompt-driven，不是確定性安裝腳本：先探索，後詢問，再展示草案，最後寫入。
目標不是把所有 Skill 都裝上，而是按項目需要組合：
- Anping 自建 Skills，例如
multi-agent-orchestrator、transfer-codex-sessions。 - 外部優秀 Skills，例如 Matt Pocock 的 engineering skills。
- 項目級規則和知識文件，例如
AGENTS.md、CONTEXT.md、CONTEXT-MAP.md、docs/agents/、docs/adr/。
運行原則
- 開始前說明執行載體。長期或多文件初始化應遵守當前項目的 multi-agent orchestration 規則；如果工具政策不允許委派，說明使用 staged fallback。
- 一次只問用戶一個部分的問題。不要把所有決策一次性拋給用戶。
- 每個推薦的 Skill 都要說明用途、來源和為什麼適合當前項目。
- 不要 vendor 第三方 Skill 源碼。外部 Skill 只通過安裝來源或引用目錄接入。
- 寫文件前先展示將要修改的文件、關鍵 block 和默認選擇，得到用戶確認後再寫。
- 不要覆蓋用戶已有的
AGENTS.md、README.md、CONTEXT.md或docs/agents/*內容；更新已有 block，避免重複追加。
工作流
1. 預檢依賴 Skills
先檢查當前會話和 ~/.codex/skills/ 中是否已有關鍵 Skills。讀取 references/skill-catalog.md，按項目需要判斷哪些是必需、推薦或可選：
- Skill 選擇和目標澄清：
ask-matt、grill-with-docs。 - 領域和知識沉澱：
domain-modeling。 - 主線程編排：
multi-agent-orchestrator。 - 工程項目配置：
setup-matt-pocock-skills。
不要自動安裝所有缺失項。先向用戶說明缺失的 Skill、來源、用途和推薦等級；用戶確認後，再使用 skill-installer 或上游推薦方式安裝。
2. 探索項目
快速讀取當前倉庫狀態，只給用戶簡短快照，不做過度結論：
git remote -v和.git/config：是否是 GitHub/GitLab/本地項目。- 根目錄
AGENTS.md、CLAUDE.md：是否已有 agent 規則或Agent skills相關章節。 - 根目錄
README.md：是否已經寫清項目目標。 - 根目錄
CONTEXT.md、CONTEXT-MAP.md。 docs/agents/、docs/adr/、src/*/docs/adr/。.scratch/：是否已有 local markdown issue convention。~/.codex/skills/或當前會話的可用 Skills：哪些自建和外部 Skills 已安裝。
3. 展示發現
用簡短列表告訴用戶：
- 當前項目大概是什麼類型。
- 已存在的 AI 協作文件。
- 缺失但可能有價值的文件。
- 已安裝/未安裝的關鍵 Skills。
- 接下來會逐步詢問哪些決策。
4. 逐步詢問
每節都先用 1-3 句話解釋用途和影響，再給默認建議，等待用戶回答後進入下一節。
A. 項目目標
如果項目目標不清楚，優先使用 ask-matt 選擇合適流程；需要邊訪談邊沉澱文檔時使用 grill-with-docs。目標達成一致後，詢問是否寫入或更新 README.md 的項目說明。
B. 主線程編排模式
詢問是否啟用 multi-agent-orchestrator。說明收益是上下文治理、獨立驗證和減少 self-validation；代價是短任務可能增加總 token。用戶同意後，繼續詢問是否寫入項目級委派授權：允許主線程在遵守 system/developer/tool policy、倉庫規則和審批要求的前提下，自主創建或使用 subagent / role agent 與用戶可見 Codex thread。用戶確認後，把主線程編排規則和授權寫入 AGENTS.md，優先使用已安裝 Skill 的模板。
C. 上下文佈局
讓用戶選擇：
Single-context：根目錄一個CONTEXT.md和docs/adr/。多數倉庫默認選這個。Multi-context：根目錄CONTEXT-MAP.md指向多個上下文目錄，適合 monorepo 或多產品倉庫。
需要寫入具體文件時，讀取 references/project-files.md。
D. 項目知識庫
詢問是否創建面向人類和 AI 的項目知識庫。默認建議：
docs/agents/anping-skills.md：本項目啟用的 Skill、用途和調用邊界。docs/agents/project-knowledge.md：項目知識沉澱規則。docs/adr/README.md：ADR 使用說明。默認使用中文書寫 ADR，除非用戶明確希望改用英文或雙語。
E. 外部 Skills 接入
按項目類型推薦外部 Skills。默認不要全裝；只推薦當前項目會用到的組合。安裝第三方 Skills 前先說明來源和理由，並請求確認。
5. 展示草案並確認
寫入前展示：
- 將修改或創建的文件列表。
AGENTS.md中擬加入/更新的章節摘要，包括是否寫入Delegation Authorization。docs/agents/anping-skills.md中擬記錄的 Skill 清單。CONTEXT.md或CONTEXT-MAP.md的佈局。- 是否安裝或建議安裝外部 Skills。
用戶確認後再執行文件修改。
6. 寫入項目配置
按用戶選擇寫入：
AGENTS.md或已有 agent 規則文件中的 Anping/Codex 協作章節。docs/agents/anping-skills.md。docs/agents/project-knowledge.md。CONTEXT.md或CONTEXT-MAP.md。docs/adr/README.md。.gitignore中的安全忽略項，例如codex_sessions/，如果項目會使用會話遷移。
如果項目也使用 setup-matt-pocock-skills，不要重複寫同一含義的 Agent skills block；更新或合併已有章節。
7. 驗證
寫入後先做輕量驗證，再彙報完成：
- 重新讀取已修改的關鍵章節，確認內容落在預期文件中。
- 檢查沒有重複的 Anping / Agent skills / Multi-Agent Orchestrator block。
- 確認應創建的文件存在，例如
docs/agents/anping-skills.md、CONTEXT.md或CONTEXT-MAP.md、docs/adr/README.md。 - 如果修改了 YAML、TOML、JSON 或其他可解析配置，使用本地解析器校驗格式。
- 如果某個選擇沒有執行，記錄原因和剩餘風險。
8. 收尾
最後彙報：
- 已啟用哪些能力。
- 修改了哪些文件。
- 哪些 Skills 已安裝，哪些只是推薦。
- 後續用戶如何說一句話觸發這些能力。
- 剩餘風險，例如外部 Skill 未安裝、GitHub 憑證不可用、項目目標仍不明確。
不要自動 commit、push 或公開上傳，除非用戶明確要求。