plan-next

name	plan-next
description	智慧推薦 CREW 當前任務下一步 —— 呼叫 crew-state.py 讀 state.json 算出下一個 /plan-* 指令並轉成人話。當使用者提到 /plan-next、「CREW 下一步指令」、「這個 spec 接下來做什麼」時觸發此 Skill。
argument-hint	[<slug>] [--all]

plan-next — 智慧推薦下一步

流程位置由 state.json（唯一權威）決定。本 skill 不自行推理流程：呼叫 crew-state.py 拿結構化答案，只負責轉成人話並附環境提醒。

紀律護欄：../../references/discipline-preamble.md（通用紀律）＋ ../../references/anti-rationalizations.md「plan-next 專用」＋ ../../references/boundaries.md「plan-next」段。

v1 舊任務：.spec/{slug}/plan.md 不存在 → 這是 v1 結構（無 state.json），依 ../../references/legacy-v1.md 的相容模式判位並提示一次。 過渡期限定，到期本段連同該檔一併刪除。

使用方式

/plan-next（當前活躍任務）｜/plan-next <slug>（指定任務）｜/plan-next --all（所有活躍任務）

流程

1. 定位任務

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/crew-state.py" list --format json

帶 <slug> → 直接用。否則：git branch --show-current 對上某任務 slug → 自動選定；只有一個未結案任務 → 自動選定；多個 → 列出讓使用者選（不得自行挑一個）；空清單 → 提示 /plan-start <任務名>。parked 非 null 的任務先問是否 /plan-status --unpark <slug>。

2. 取得下一步

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/crew-state.py" next --slug <slug> --format json

回傳的 command 與 reason 就是答案，照實轉述，不得改寫或另給建議。command 為 null（例：已結案）→ 不推薦任何指令，只轉述 reason。exit 1（查無任務／參數錯）→ 見 Gotchas；其他非 0 exit（例：取不到檔案鎖）→ 照 script 訊息明說「讀不到狀態」，不要猜流程位置。--all 直接用步驟 1 結果（每筆已含 next），不必逐一再呼叫。 接手中斷任務時，若 .spec/<slug>/state.json 的 work_unit.ambiguities 非空，把那些歧義點列在建議之前（中斷前留下的未決問題，先看再動手）。

3. 順帶提醒（獨立於主建議，最多 3 行）

條件	提醒
inferred 為 true（狀態由 rebuild 推測而來）	⚠️ 狀態為推測，請確認後再繼續
當前 branch ≠ 任務分支（唯讀取 .spec/<slug>/state.json 的 resume_hint.branch，非 null 才比）	提示 git checkout <branch>
CLAUDE.md 不存在	提示 /init
專案未在 projects/ 註冊	提示 /project-add

4. 輸出格式

一行標頭（{name}（{slug}）｜🌿 {branch}｜📂 階段：{phase}；list 沒有 branch 欄位，{branch} 取步驟 3 讀到的 resume_hint.branch，為 null 就整段省略）＋ 💡 下一步：{command} ＋ 理由：{reason} ＋ 順帶提醒（如有）。 --all 模式每任務一行 {slug}（{phase}｜停滯 N 天）→ {command}，不顯示順帶提醒。

何時不用

一般對話「接下來呢」→ 直接回答｜任務清單 → /plan-status｜規劃內容 → /plan-browse｜文件與程式碼是否同步 → /plan-drift

Gotchas

• 狀態檔缺失或 exit 1：不要退回「猜哪些檔案存在」。先跑 crew-state.py rebuild --slug <slug> 自我修復（結果會標 inferred），仍失敗才提示確認目錄狀態後重跑 /plan-start <同任務簡述>。
• 決策表不在本檔：流程決策是 crew-state.py next 的 Python 實作。要改流程改那裡，別在 SKILL.md 複製一份（複製即漂移）。
• bug 型任務走同一套階段機：next 的決策不看 type，bug 與 feature 拿到的都是 /plan-* 指令（實作見 crew-state.py 的 _compute_next_rule）。/bug-investigate／/bug-fix 不在 next 的回傳範圍；使用者做的是 bug 調查時照 script 建議轉述並補一句說明，不要自行改推 /bug-*。