القائمة
CREW 環境健診 —— 一次性檢查 CREW 所有必要與選配依賴（Node/Git/Notion MCP/Agent Teams/瀏覽器 MCP/config/專案註冊/CLAUDE.md），列出綠黃紅燈與修法。當使用者提到 /crew-doctor、「CREW 環境健診」、「CREW 為什麼不能用」時觸發此 Skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
瀏覽與探索已有的 .spec/ 規劃文件 —— 深度閱讀、跨任務比較、模式搜尋。當使用者提到 /plan-browse、「瀏覽 .spec 規劃」、「看之前的規劃設計」時觸發此 Skill。
從 .spec/{slug}/plan.md 以 Agent Teams leader-delegate 模式產生程式碼，含退出驗證與錨點有效性檢查，Leader 只協調不寫 code。當使用者提到 /plan-build、「從 spec 產生程式碼」、「plan-build 產碼」時觸發此 Skill。
結案前先跑文件漂移硬關卡（FAIL 擋、WARN 需明示放行），通過後蓋章 verified_at_commit、提交 Git、批次同步 plan.md 與 deploy.sql 到 Notion。當使用者提到 /plan-close、「feature 結案」、「同步 spec 到 Notion 並結案」時觸發此 Skill。
智慧推薦 CREW 當前任務下一步 —— 呼叫 crew-state.py 讀 state.json 算出下一個 /plan-* 指令並轉成人話。當使用者提到 /plan-next、「CREW 下一步指令」、「這個 spec 接下來做什麼」時觸發此 Skill。
CREW 規劃 —— spec / db / arch 三個 pass 把決策與驗收條件寫進 .spec/{slug}/plan.md，DB 設計另產 deploy.sql（零 Notion 呼叫）。當使用者提到 /plan、「CREW 完整規劃」、「一次跑完 spec/db/arch」時觸發此 Skill。
列出 .spec/ 目錄中所有活躍與已完成的任務（純本地操作，不呼叫 Notion）。當使用者提到 /plan-status、「.spec 任務狀態」、「CREW 任務列表」時觸發此 Skill。
| name | crew-doctor |
| description | CREW 環境健診 —— 一次性檢查 CREW 所有必要與選配依賴（Node/Git/Notion MCP/Agent Teams/瀏覽器 MCP/config/專案註冊/CLAUDE.md），列出綠黃紅燈與修法。當使用者提到 /crew-doctor、「CREW 環境健診」、「CREW 為什麼不能用」時觸發此 Skill。 |
一次性檢查 CREW 運作所需的所有依賴與設定，在執行 Skill 前先告訴你 什麼能跑、什麼缺什麼、缺的怎麼補。比「等噴錯再排查」省時得多。
紀律護欄：
../../references/discipline-preamble.md（通用紀律）＋../../references/anti-rationalizations.md「crew-doctor 專用」＋../../references/boundaries.md「crew-doctor」段。
/crew-doctor # 完整健診（所有 20 項）
/crew-doctor --quick # 只跑紅燈項目（8 項必要）
/crew-doctor --fix # 健診同時嘗試自動修復可修復項目
| # | 項目 | 檢查方式 | 缺失時提示 |
|---|---|---|---|
| 1 | Node.js ≥ 18 | node --version | 對應 OS 安裝指令 |
| 2 | Git | git --version | 對應 OS 安裝指令 |
| 3 | Notion MCP | claude mcp list 含 notion 或 notion-local | claude plugin install notion |
| 4 | Agent Teams 啟用 | $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 | 加入 ~/.claude/settings.json 的 env |
| 5 | CLAUDE.md 在當前專案 | ls CLAUDE.md | /init |
| 6 | bug-workflow 設定檔 | ~/.claude-company/bug-workflow-config.md | /bug-setup |
| 7 | feature-workflow 設定 | ~/.claude-company/feature-workflow/config.md | /plan-setup |
| 8 | 專案註冊 | ~/.claude-company/feature-workflow/projects/{repo-id}.md | /project-add |
| # | 項目 | 檢查方式 | 缺失時影響 |
|---|---|---|---|
| 9 | Playwright MCP | claude mcp list 含 playwright | plan-verify 降級或無法執行 |
| 10 | Maven / Gradle | which mvn 或 which gradle | plan-build E4 編譯驗證跳過 |
| 11 | CREW hooks 已載入 | 見下方「#11 CREW hooks 已載入」 | 開 session 時不會提醒未結案任務，中斷的任務容易被遺忘（plan-close 沒做到） |
| # | 項目 | 檢查方式 | 缺失時影響 |
|---|---|---|---|
| 12 | chrome-devtools MCP | claude mcp list 含 chrome-devtools | plan-verify --deep 不可用 |
| 13 | DBHub MCP | claude mcp list 含 dbhub | DB 直連功能不可用，plan-build DB 工程師退場 |
| 14 | .NET SDK ≥ 8 | dotnet --version | Word 報告降級為 python-docx 排版 |
| 15 | python-docx | python3 -c "import docx" | 完全無 Word 報告能力（需先裝 .NET 或 docx） |
| 16 | v1 舊結構任務 | 當前專案有 .spec/*/ 含 README.md 但無 plan.md 的目錄 | 這些任務走相容模式；過渡期到期後不再支援 → 提示 /plan-status --migrate {slug}，並指向 feature-workflow/references/legacy-v1.md（過渡期檢查項，到期連同該檔一併移除） |
| # | 項目 | 檢查方式 |
|---|---|---|
| 17 | Notion 可讀 | 用 notion-search 試查 1 個現有頁面 |
| 18 | 任務追蹤工具可達 | 從設定檔讀 ID，試 retrieve-a-data-source |
| 19 | 設定檔欄位完整 | bug-workflow-config.md 必含「任務追蹤工具」「專案資料庫」ID |
| 20 | 共用 reference 漂移 | 若 marketplace 原始碼在本機，跑 check-shared-refs.py |
兩個 CREW plugin 各裝一個 SessionStart hook，在每次開啟 session 時於本機執行
scripts/crew-state.py session-brief，讀取當前專案的 .spec/*/state.json，列出未結案任務。
不外送任何資料、不寫入專案檔案；無 .spec/ 或全部結案時零輸出。詳見 plugin README 的
「SessionStart hook（自動執行揭露）」段。
檢查步驟（三項全綠才算通過）：
| 步驟 | 指令 | 綠燈條件 |
|---|---|---|
| a. hook 設定檔存在 | ls "$(claude plugin list --json | ...)" 或直接找已安裝路徑下的 hooks/hooks.json | 兩個 plugin 各有一份 |
| b. python3 可執行 | python3 --version | 有輸出（hook 指令用 python3，找不到就整個 hook 靜默失效） |
| c. 指令實際可跑 | python3 <plugin>/scripts/crew-state.py session-brief --cwd . < /dev/null | exit 0（有未結案任務才有輸出，無則零輸出，兩者皆為正常） |
| 狀態 | 判定 |
|---|---|
| ✅ 綠 | a/b/c 全過 |
| ⚠️ 黃 | a 過但 b 或 c 失敗 → 提示：hook 已註冊但跑不起來，開 session 不會有提醒 |
| ⚠️ 黃 | a 失敗 → 提示：plugin 版本過舊或未重啟。修法：/crew-upgrade 後重啟 Claude Code（hook 變更不會熱載入） |
此項永遠不會是紅燈 —— hook 只做提醒，缺少它不影響任何 Skill 執行。
case "$(uname)" in
Darwin*) OS=macos ;;
Linux*) OS=linux ;;
MINGW*|MSYS*|CYGWIN*) OS=windows ;;
esac
OS 決定缺失提示的指令（例如 brew install node vs winget install Node）。
依序執行，每項通過或失敗都立即顯示在輸出中。 紅燈項目不阻擋後續檢查（要把完整圖像給使用者）。
執行後標示為 🟡 警告或 🔵 選配。 #11（CREW hooks）純本地檢查，不需 Notion，也不需網路。
Notion 相關檢查需要實際 API call，每項 1-3 秒。 若 #3 紅燈，跳過 #17-20（沒有 Notion 後端跑不了，含共用 reference 漂移檢查）。
==========================================
CREW 環境健診摘要
==========================================
🔴 紅燈 0 項
🟡 黃燈 1 項
🟢 綠燈 14 項
🔵 選配 5 項（其中 2 項未安裝）
可用 Skill 評估：
✅ bug-investigate / bug-fix / bug-close 可用
✅ /plan（spec/db/arch 三 pass）/ plan-build 可用
⚠️ plan-verify 降級：Playwright 未裝，無法做瀏覽器驗收
🔵 plan-verify --deep 不可用：chrome-devtools 未裝（影響有限）
建議下一步：
1. 安裝 Playwright 解開 plan-verify：
claude mcp add playwright --scope user -- \
npx @playwright/mcp@latest
--fix 模式對下列項目嘗試自動修復：
| 項目 | 修法 |
|---|---|
| ~/.claude-company/feature-workflow/ 缺失 | mkdir -p |
| ~/.claude-company/feature-workflow/projects/ 缺失 | mkdir -p |
| ~/.claude-company/feature-workflow/stacks/ 缺失 | mkdir -p |
| CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 未設 | 寫入 ~/.claude/settings.json 的 env（先備份原檔） |
不會自動修復（仍要使用者操作）：
claude plugin/mcp 指令）/init）/bug-setup 互動建立）--fix 修了什麼會明確列出，並建議再跑一次 /crew-doctor 確認。
本 Skill 為 LLM 驅動的健診流程，無腳本可回傳退出碼；健診結果以下列狀態呈現在摘要中：
| 狀態 | 意義 |
|---|---|
| 🟢 綠 | 紅燈全過（不論黃燈、選配如何） |
| 🔴 紅 | 有必要項目（#1-8）未通過 |
| ⚠️ 異常 | 健診本身執行錯誤（檔案 IO、permission），提示無法完成健診 |
==========================================
🔍 CREW 環境健診（v3.9.0）
==========================================
🔴 必要項目（8）
✅ Node.js v18.20.4
✅ Git 2.45.0
❌ Notion MCP 未安裝
→ 修法：claude plugin install notion
→ 安裝後重啟 Claude Code
✅ Agent Teams 啟用（settings.json）
✅ CLAUDE.md 存在於 /Users/cheng/IdeaProjects/MyProject
✅ bug-workflow-config.md 存在
✅ feature-workflow/config.md 存在
❌ 專案未註冊（找不到 projects/{repo-id}.md）
→ 修法：/project-add
🟡 強烈建議（3）
✅ Playwright MCP 已安裝
⚠️ Maven / Gradle 未找到
→ 影響：plan-build E4 編譯驗證會跳過
✅ CREW hooks 已載入（bug-workflow + feature-workflow，python3 3.11.9）
🔵 選配（5）
⚫ chrome-devtools MCP 未安裝（--deep 模式不可用）
✅ DBHub MCP 已安裝
✅ .NET SDK 8.0.100
⚫ python-docx 未安裝（有 .NET 不影響）
✅ 無 v1 舊結構任務
🔍 進階檢查（4）
⏭️ 跳過：紅燈未過（Notion MCP 缺失）
==========================================
摘要：紅燈 2、黃燈 1、綠燈 13、選配 5
建議：先 claude plugin install notion，再 /project-add
==========================================
investigate skill 或 superpowers:systematic-debugging/crew-init/crew-upgradeclaude mcp list 輸出格式：不同版本可能變動，需用 grep / awk 適配%USERPROFILE%、Unix 用 $HOME--fix 改 settings.json 風險：先 cp settings.json.bak，失敗能還原claude plugin list 顯示 enabled 才算可用claude CLI 本身找不到：跳出健診，提示「請確認 Claude Code 已安裝」hooks/hooks.json，找不到屬正常，提示 /crew-upgrade 即可，不算故障hooks/hooks.json 檔案在但 hook 尚未生效，需重啟 Claude Code