crew-init
CREW 一鍵首次設定 —— 把 bug-workflow 與 feature-workflow 的初次設定整合成單一指令。當使用者提到 /crew-init、「CREW 一鍵設定」、「初始化 CREW」時觸發此 Skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
CREW 一鍵首次設定 —— 把 bug-workflow 與 feature-workflow 的初次設定整合成單一指令。當使用者提到 /crew-init、「CREW 一鍵設定」、「初始化 CREW」時觸發此 Skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
CREW 環境健診 —— 一次性檢查 CREW 所有必要與選配依賴(Node/Git/Notion MCP/Agent Teams/瀏覽器 MCP/config/專案註冊/CLAUDE.md),列出綠黃紅燈與修法。當使用者提到 /crew-doctor、「CREW 環境健診」、「CREW 為什麼不能用」時觸發此 Skill。
瀏覽與探索已有的 .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。
| name | crew-init |
| description | CREW 一鍵首次設定 —— 把 bug-workflow 與 feature-workflow 的初次設定整合成單一指令。當使用者提到 /crew-init、「CREW 一鍵設定」、「初始化 CREW」時觸發此 Skill。 |
| argument-hint | [--skip-bug] [--skip-plan] [--resume] |
統合首次設定流程,讓新使用者只記得一個指令:
/crew-init
依序執行:
/bug-setup(建立 Notion 資料庫 + bug-workflow 設定檔)/plan-setup(匯入共用 ID + feature-workflow 設定)/init(如當前專案無 CLAUDE.md)/project-add(如當前專案未註冊)紀律護欄:
../../references/discipline-preamble.md(通用紀律)+../../references/anti-rationalizations.md「crew-init 專用」+../../references/boundaries.md「crew-init」段。
/crew-init # 完整跑首次設定流程
/crew-init --skip-bug # 強制跳過階段 1,不執行 1a 偵測
/crew-init --skip-plan # 強制跳過階段 2,不執行 2a 偵測
/crew-init --resume # 從中斷點續跑,跳過各階段提示直接執行
三者關係:階段 1a/2a 本身就會自動偵測設定檔並跳過已完成的階段,因此單純重新執行 /crew-init(不加任何旗標)即等同於續跑。--skip-bug/--skip-plan 是使用者明確斷言「已完成」時的手動旗標,會跳過 1a/2a 的偵測直接進下一階段(用於偵測邏輯誤判或想省下檢查時間的情況);--resume 不改變偵測邏輯,差異只在於不顯示「即將執行 X」的互動提示,直接執行未完成階段。
執行前自動檢查(不通過則先處理):
| 項目 | 不通過時 |
|---|---|
| Node.js ≥ 18 | 顯示對應 OS 安裝指令並終止 |
| Git | 顯示對應 OS 安裝指令並終止 |
| Notion MCP 已安裝 | 提示 claude plugin install notion,等使用者完成後重跑 |
進階檢查交由 /crew-doctor(完整 18 項,含必要 8 項),本 skill 只跑上表必要 3 項即可開始。
檢查設定檔是否存在(依序):
~/.claude-company/bug-workflow-config.md~/.claude/bug-workflow-config.md已存在 → 標示為 ✅ 跳過,進階段 2。 不存在 → 進 1b。
提示使用者:
階段 1/4:建立 bug-workflow 設定
即將執行 /bug-setup,這會:
- 偵測 Notion Workspace 中的「任務追蹤工具」「專案資料庫」資料庫
- 若不存在則引導從零建立(含標準欄位 + Views + Relation)
- 產出設定檔到 ~/.claude-company/bug-workflow-config.md
需要你的互動(選資料庫、確認 ID 等)
[Enter 繼續,Ctrl+C 終止]
呼叫 /bug-setup 流程(同 plugin 內可直接觸發),完成後驗證設定檔存在。
bug-setup 失敗或使用者中斷 → 停止 crew-init,提示「下次可用 /crew-init --resume 從這裡續跑」。
檢查設定目錄(新版階層式):
~/.claude-company/feature-workflow/config.md~/.claude/feature-workflow/config.md若以上皆不存在,再檢查舊單一檔格式(向下相容,同 /plan-setup 的偵測邏輯):
3. ~/.claude-company/feature-workflow-config.md
4. ~/.claude/feature-workflow-config.md
新版或舊版任一存在 → 標示為 ✅ 跳過,進階段 3(偵測到舊版時附註:可執行 /plan-setup --migrate 遷移到新階層式目錄,非必要)。
皆不存在 → 進 2b。
提示:
階段 2/4:建立 feature-workflow 設定
即將執行 /plan-setup,這會:
- 自動匯入 bug-workflow 共用的 Notion ID(任務追蹤工具、專案資料庫)
- 提示是否建立「功能設計庫」資料庫(選填)
- 偵測或設定常用技術棧
- 產出 ~/.claude-company/feature-workflow/config.md + stacks/
[Enter 繼續]
呼叫 /plan-setup,完成後驗證 config.md 存在。
讀取當前 working directory 是否有 CLAUDE.md:
test -f CLAUDE.md
有 → 標示為 ✅ 跳過,進階段 4。 無 → 進 3b。
階段 3/4:當前專案 CLAUDE.md
偵測當前目錄:{pwd}
此目錄無 CLAUDE.md,無法執行 plan-* / bug-* 指令。
請執行(Claude Code 內建指令,非本 plugin):
/init
執行後建議將 CLAUDE.md commit 到 Git,讓團隊共用:
git add CLAUDE.md && git commit -m "docs: 新增 CLAUDE.md" && git push
[Enter 我已執行 /init,或 s 跳過此步驟]
使用者選擇 Enter 後重新檢查;選 s 則標示為 ⚠️ 跳過。
讀取 Git remote 取得 repo identifier:
git remote get-url origin
# 解析為 {owner}/{repo} 或 {project}/{repo}
檢查 ~/.claude-company/feature-workflow/projects/{repo-id}.md 是否存在。
已存在 → 標示為 ✅ 跳過,進結尾摘要。 不存在 → 進 4b。
階段 4/4:專案註冊
當前專案:{repo-id}
此專案尚未註冊,無法用 plan-* / bug-* 指令。
請執行:
/project-add
這會:
- 偵測專案類型(簡單型 / 產品型)
- 偵測建置工具、技術棧、DB 類型
- 註冊到 Notion 專案資料庫
- 可選安裝 DB MCP(DBHub)
[Enter 我已執行 /project-add,或 s 跳過]
═══════════════════════════════════════════
🎉 CREW 一鍵設定完成
═══════════════════════════════════════════
階段 1/4 bug-workflow 設定 ✅
階段 2/4 feature-workflow 設定 ✅
階段 3/4 當前專案 CLAUDE.md ✅
階段 4/4 專案註冊 ✅
可用指令:
/bug-investigate 開始調查 Bug
/plan-start <任務簡述> 建立功能任務
/plan-next 查看下一步建議
進階:
/crew-doctor 18 項依賴完整檢查
/crew-upgrade 更新 CREW plugins
若有跳過步驟,摘要會顯示 ⚠️ 並提示對應的單獨指令補做。
省略階段 1-4 中已 ✅ 的部分,直接進到第一個未完成階段。
實作上 --resume = 跑每階段的偵測(1a/2a/3a/4a),自動跳過 ✅,從第一個未完成處執行。
與不加 --resume 的差別:不加時每階段都顯示提示「即將執行 X」;加 --resume 時跳過提示直接執行。
/bug-setup/plan-setup/project-add/init/crew-doctor--resume 接續git remote 不受影響,但專案路徑要正確引用git remote 失敗時,標示為 ⏭️ 不適用(非 git 專案不需註冊)~/.claude-company/,重複設定會偵測為已存在自動跳過