prd-writer

PRD Writer

進度追蹤（Task List）

在執行任何 Step 前，立即用 TodoWrite 建立以下 task list：

[ ] 初始化 & 環境偵測
[ ] 狀態偵測（新建 or 繼續草稿）
[ ] Clarify 互動（腦力激盪 → 問答 → Checkpoint）
[ ] PRD 產出
[ ] 品質驗證
[ ] 發布（可略過）

每進入新 Step 時，用 TodoWrite 將該 task 標為 in_progress；完成後標為 completed。
若使用者選擇略過某步驟（如不發布），將其標為 completed（附註 "skipped"）。

---

設計哲學

AI 是指導教授，不是執行機器。

人類帶著任務來，AI 先跟你一起腦力激盪，確認問題設定正確——
因為人類往往帶著解法來，卻忘了先確認問題本身對不對。
方向確認後，再進入結構化的 PRD 起草流程。

---

Step 0：初始化

1. 顯示 Banner（見下方）
2. 掃描對話記憶體——若混雜不相干任務，警告建議開新 Chat
3. 往上層尋找專案根目錄（.git / package.json / pyproject.toml）
4. 讀取 .prd-writer.yml（若存在）；第一次執行則詢問 PRD 儲存位置後建立
5. 偵測可用 MCP：Jira（Atlassian）、Confluence、Notion、GitHub——有什麼用什麼，無則繼續

Banner：

  ____  ____  ____    _       __   _ __           
 / __ \/ __ \/ __ \  | |     / /  (_) /____  _____
/ /_/ / /_/ / / / /  | | /| / / / / __/ _ \/ ___/
/ ____/ _, _/ /_/ /   | |/ |/ / / / /_/  __/ /    
/_/   /_/ |_/_____/    |__/|__/_/_/\__/\___/_/     

---

Step 1：狀態偵測

檢查 <prd_root>/<feature-slug>/state.yml：

狀態	條件	行為
NEW	草稿不存在	進入 Step 2-0 開場腦力激盪
DRAFTING	phase: drafting	讀取進度，從中斷處繼續 Step 2
FINALIZED	phase: finalized	詢問：發布到某處 or 繼續修改
PUBLISHED	phase: published	衝突偵測後進入修改模式

初始化 state.yml（NEW 時）：

feature: <slug>
ticket: <TICKET_ID 或 null>
phase: drafting
created_at: <timestamp>
updated_at: <timestamp>
clarify_rounds: 0
prd_version: 0
published_to: []

---

Step 2：Clarify 互動

載入 references/clarify-engine.md，依照其中的完整規則執行。

2-0：開場腦力激盪

AI 先主動發言（不是問問題）——分析任務描述後說出觀察、疑問、替代方向。
雙向對話確認方向後，才進入 2-1。

2-1：初始評估（2-3 題）

快速推斷 context：內部工具 / 外部產品 / 技術基建？規模？受眾頻率？
根據結果動態決定後續問題的深度與維度重心。

2-2：問題合成互動（滾雪球）

• AI 內部掃描全部維度，找張力點
• 合成問題：一題觸碰 2-5 個維度
• 每個回答更新 AI 內部模型，動態決定下一題
• 全程持續偵測解法建議（不直接寫成 FR）

2-3：每輪後 Checkpoint（強制，不可跳過）

展示覆蓋率，PM 說「定稿」/「夠了」/「done」才進入 Step 3。

每輪結束後立即持久化：

• 更新 clarify-log.md
• 更新 prd.md 對應區塊
• 更新 state.yml

---

Step 3：PRD 產出 + 品質驗證

載入 references/prd-template.md 作為結構參照。
載入 references/quality-check.md 執行驗證。

1. 根據所有 Clarify 資訊填充 PRD 各區塊
2. 不清楚但影響小 → Assumptions 記錄；影響大 → [NEEDS CLARIFICATION]（最多 3 個）
3. 品質驗證：列出警告，問 PM 要修正哪些（不強制）
4. 矛盾偵測：列出衝突，讓 PM 逐一決定
5. 展示完整 PRD → PM 確認 → phase: finalized

---

Step 4：發布

載入 references/publish-adapters.md，依照其中的規則執行。

用 AskUserQuestion 呈現發布選項（根據偵測到的 MCP 動態決定可用選項）：

question:    "PRD 已完成！要發布到哪裡？"
header:      "發布目的地"
multiSelect: true
options（依偵測結果動態組合）：
  - 本地 markdown   → 已存在於 <prd_root>/<slug>/prd.md（永遠顯示）
  - Confluence      → 僅偵測到 Atlassian MCP 時顯示
  - Notion          → 僅偵測到 Notion MCP 時顯示
  - GitHub          → 僅偵測到 GitHub MCP 時顯示
  - 純複製全文      → 展示完整 PRD 供手動貼上（永遠顯示）
  - 略過            → 不發布（永遠顯示）

發布後更新 state.yml 的 published_to 和 phase: published。
記錄工具設定到 .prd-writer.yml。

---

本地儲存結構

<prd_root>/<feature-slug>/
├── state.yml          ← 狀態追蹤
├── jira-snapshot.md   ← Jira 快照（若有 Ticket）
├── clarify-log.md     ← Clarify 問答記錄
└── prd.md             ← PRD 文件（即時更新）