---
name: bmad-run-story
description: 為單一 BMAD story 依序跑三階段（bmad-create-story → bmad-dev-story → bmad-code-review），每階段委派給一個全新 context 的 subagent 執行，主線只做協調、階段之間停下等使用者確認。code-review 會審查＋收官（回填發現、依結果切狀態），但不自動修 code；被審出的 patch 修不修由使用者裁示。僅由使用者輸入 /bmad-run-story 明確呼叫，不自動觸發。
disable-model-invocation: true
---

# BMAD Story 三階段流水線（協調器版）

為指定的 story 編號依序跑 BMAD 的三個階段（建立 story 檔 → 實作 → 審查）。你（讀到這份 skill 的主線）是**協調器 A**：自己不讀檔、不寫碼、不模擬 BMAD，把每一個階段整包委派給一個**全新 context 的 subagent** 去跑，只把摘要收回來。

## 協調器鐵則

- **A 不親自幹活**：不自己讀 story／原始碼、不自己實作、不自己模擬 BMAD workflow。每個階段都用 Agent tool 派一個 subagent 去跑。這讓 A 的 context 保持精瘦——正因為 A 不累積各階段的重內容，跨階段時「要停下等確認」這條指示才不會被稀釋。
- **一次只派一個階段**：派出該階段的 subagent → 等它回報 → 把摘要轉述給使用者 → **停下等使用者確認** → 使用者同意後才派下一階段。不要連續派兩個階段。
- **subagent 同步執行**：以 `run_in_background: false` 派發，等它回報再繼續，不要在它還沒回來就往下走。

## 前置檢查

1. **確認 BMAD 已安裝**：available skills 清單中必須同時存在 `bmad-create-story`、`bmad-dev-story`、`bmad-code-review`。缺任何一個就中止，告知使用者此專案未安裝 BMAD（或版本不含該 workflow），不要用自己的理解模擬 BMAD 流程替代。
2. **確認 story 編號**：使用者若已在指令中帶了編號（如 `/bmad-run-story 3-2`）直接採用；沒有就先問「這次要跑的 story 編號是？」，拿到再繼續。編號格式依專案慣例（`3`、`2-1`、`epic2-story3` 等），原樣使用、不改寫。

## 進度帳本

**建立前先清光現有 task**：用 TaskList（或內建 todo 清單）先看現有 task，把**所有現存 task 一律刪除**（不分編號，含本 story 之前殘留的、其他 story 殘留的），再新建本 story 三個。每次 /bmad-run-story 都是乾淨重建，不沿用、不接續既有 task——確保清單只反映本次這一輪的進度，不被舊殘留干擾。

刪除前若現存 task 中有未完成項目，回報時附帶一句提醒使用者（例如「已清除先前殘留的 story {編號} task」），讓使用者知道清掉了什麼。

用 TaskCreate 建三個 task，標題帶 story 編號，以依賴關係串成固定順序（後一個依賴前一個）：

1. `create-story: story {編號}`
2. `dev-story: story {編號}`
3. `code-review: story {編號}`

這是**進度指標**，不是「一次清光的待辦」——task 還有未完成項目，不是繼續派下一階段的理由；唯一的推進訊號是使用者的確認。若環境沒有 task 工具，改用內建 todo 清單，行為不變。

## 逐階段委派

每個階段節奏相同：對應 task 標 in_progress → 用 **Agent tool** 派一個 `general-purpose` subagent（需具備 Skill、Read/Write/Edit/Bash 工具）→ subagent 回報後把 task 標 completed → 轉述摘要 → **停下等使用者確認**。

給各階段 subagent 的指示（**必須自包含**，subagent 不會讀到這份 skill）：

| 階段 | 派給 subagent 的指示 | 回收 |
|------|---------------------|------|
| 1 create-story | 「你在一個獨立 context 裡只跑一個 BMAD workflow。用 Skill tool 呼叫 `bmad-create-story`（story 編號 {編號}）跑到完成，不要用自己的理解模擬 BMAD。完成後只回傳：story 檔路徑 + 內容重點摘要。除此之外什麼都別做。若 Skill tool 裡沒有這個 skill、無法呼叫，直接回報『無法呼叫 bmad-create-story』。」 | story 檔路徑、摘要 |
| 2 dev-story | 「你在一個獨立 context 裡只跑一個 BMAD workflow。用 Skill tool 呼叫 `bmad-dev-story`（story 編號 {編號}）跑到完成。過程中**自主做合理的實作決定、不要停下來等使用者輸入**（你無法與使用者對話）。完成後回傳：變更的檔案清單、測試結果、以及任何你替使用者做了、需要對方事後拍板的關鍵決定或待確認問題。若無法呼叫 bmad-dev-story，直接回報。」 | 變更檔案、測試結果、待拍板決定 |
| 3 code-review | 「你在一個獨立 context 裡只跑一個 BMAD workflow。用 Skill tool 呼叫 `bmad-code-review`（story 編號 {編號}）**跑到完成，含它自己的收官步驟——把 Review Findings 回填 story 檔、並依審查結果同步 story Status 與 sprint-status.yaml（這些是文件寫入，照常執行、不要跳過）**。**唯一禁止**：不要動被審出的『程式碼』（patch 類發現不自動修 code，留給使用者裁示）。完成後回傳：發現清單 ＋ code-review 判定的新狀態（`done` / `in-progress`）＋ 是否有未解 patch/HIGH/MEDIUM。若無法呼叫 bmad-code-review，直接回報。」 | review 發現清單、新狀態 |

**dev-story 是自主跑的**：C 不與使用者互動，人審移到階段邊界——A 收到 C 的回報後停下，把「C 替你做的關鍵決定／待確認問題」一起攤給使用者看，由使用者決定要不要回頭調整。

**階段 3＝審查 ＋ 收官，但不自動修 code**：bmad-code-review 會自己回填 Review Findings 並依結果切狀態（patch/decision 全解且無殘留 HIGH/MEDIUM → `done`，否則 `in-progress`）——**這步是文件寫入，照常讓它跑、別用「不要修改」把它一起擋掉**。「不自動修」限定於**被審出的程式碼 patch**：修不修、怎麼修由使用者裁示，使用者明確要求修復時那是新的指示，屆時再派 subagent 或直接處理。

**收官回路（易漏，務必補）**：若審查留下未解的 patch/HIGH/MEDIUM，story 會停在 `in-progress`（或仍是 dev-story 留下的 `review`）。**使用者事後要求修復、修完之後，必須回頭補跑 code-review 收官**——重判狀態 ＋ 在 Review Findings 標記該項已解 ＋ 同步 sprint-status.yaml，不能只改 code、commit 就當結束，否則狀態永遠切不到 `done`。收官方式：再派一個 subagent 呼叫 bmad-code-review 複審收官，或在主線直接依 bmad-code-review `steps/step-04-present.md` §2（回填）／§6（狀態判定＋sprint-status 同步）補做。

**狀態語意**：`review` 是 dev-story 的終態、**不是** code-review 的終態；story 要離開 `review`（到 `done` 或 `in-progress`）一定得經過 code-review step-04 §6 的狀態判定，沒有別條路。跑完階段 3 若 story 仍停在 `review`，代表 §6 沒被執行（多半是被「不要修改任何檔案」誤擋）——這是 bug，回頭補收官。

## Fallback：subagent 無法呼叫 bmad skill

若某階段 subagent 回報「無法呼叫 bmad-<phase>」（子 agent 環境沒帶 Skill tool 或看不到專案 skill），A 改在主線直接用 Skill tool 呼叫該階段的 bmad skill 跑完，其餘協調節奏（標 task、回報、停下等確認）不變。

## 中止與失敗

- 任一階段失敗：對應 task 保持原狀態，回報失敗原因與已完成的部分，不自動重試、不跳過該階段續跑後面的。
- 使用者中途喊停：停在當下，保留當前 task 清單現狀不動（不主動刪）。注意下次重新 /bmad-run-story 會依「進度帳本」清光現存 task 重建，不靠既有 task 接續；使用者若要接續，屆時自行從想繼續的階段開始確認推進。