Product Diagnosis

產品診斷（G0 前置檢查）

在開發啟動前，用六問框架診斷產品方向，確保 G0 提案品質。

使用方式

/product-diagnosis 

參數

• $ARGUMENTS: 專案名稱或描述（可選，若不提供則詢問）

適用時機

• Sprint 提案書撰寫前
• 新功能規劃前
• PM 提出需求但方向不明確時
• 老闆要求進行可行性評估時

六問診斷框架

依序回答以下六個問題，每個問題必須有明確結論：

Q1: 問題存在嗎？（Problem Validation）

> 我們要解決的問題，用戶真的有感嗎？

| 檢查項 | 說明 | |--------|------| | 痛點來源 | 這個問題從哪裡來的？（用戶回饋 / 數據異常 / 老闆直覺 / 競品觀察） | | 頻率 | 這個問題多常發生？（每天 / 每週 / 偶爾） | | 嚴重度 | 不解決會怎樣？（流失用戶 / 降低效率 / 無影響） | | 現有替代方案 | 用戶現在怎麼解決？成本高嗎？ |

結論: [ ] 問題真實存在且值得解決 / [ ] 問題存在但優先級低 / [ ] 問題不成立

---

Q2: 目標用戶是誰？（User Definition）

> 這個功能是給誰用的？他們的使用場景是什麼？

| 檢查項 | 說明 | |--------|------| | 用戶角色 | 老闆 / Agent / 兩者皆是 | | 使用頻率 | 每天 / 每週 / 每個 Sprint / 一次性 | | 技術水平 | 需要理解底層原理嗎？ | | 關鍵場景 | 描述 1-2 個最核心的使用場景 |

結論: [ ] 用戶輪廓清晰 / [ ] 需要進一步釐清

---

Q3: 解法合理嗎？（Solution Fitness）

> 我們提出的解法，是不是最簡單有效的？

| 檢查項 | 說明 | |--------|------| | 複雜度 vs 價值 | 實作成本和帶來的價值成比例嗎？ | | 有沒有更簡單的做法 | 能用現有功能組合解決嗎？能用 Skill/Hook 而非新 IPC 嗎？ | | 技術可行性 | 在當前架構下可行嗎？需要大改架構嗎？ | | 邊界情況 | 有沒有明顯的 edge case 會讓方案崩潰？ |

結論: [ ] 解法合理 / [ ] 有更好的替代方案 / [ ] 技術上有風險

---

Q4: 範圍明確嗎？（Scope Clarity）

> 這個任務的邊界在哪裡？什麼做、什麼不做？

| 檢查項 | 說明 | |--------|------| | 必做（Must Have） | 列出核心功能點 | | 不做（Out of Scope） | 明確排除哪些功能 | | 驗收標準 | 怎麼判斷「做完了」？ | | 依賴 | 需要其他任務先完成嗎？ |

結論: [ ] 範圍清晰可執行 / [ ] 範圍過大需拆分 / [ ] 範圍模糊需釐清

---

Q5: 符合架構嗎？（Architecture Alignment）

> 這個功能和現有架構一致嗎？會破壞什麼嗎？

讀取以下文件進行比對：

1. .knowledge/architecture.md — 系統架構
2. .knowledge/coding-standards.md — 編碼規範
3. .knowledge/postmortem-log.md — 是否有相關踩坑紀錄

| 檢查項 | 說明 | |--------|------| | IPC 四方同步 | 新增 IPC 通道是否遵守四方同步規則？ | | 資料流向 | 資料從哪來到哪去？有沒有繞過正規路徑？ | | 命名規範 | 新增的命名是否符合現有慣例？ | | 歷史教訓 | postmortem-log 中有沒有相關的踩坑紀錄？ |

結論: [ ] 符合架構 / [ ] 需要小幅調整 / [ ] 需要架構決策（提交老闆）

---

Q6: 風險可控嗎？（Risk Assessment）

> 最壞的情況是什麼？我們能承受嗎？

| 風險類型 | 評估 | |---------|------| | 時間風險 | 能在 1 個 Sprint 內完成嗎？ | | 技術風險 | 有沒有不確定的技術難題？ | | 回歸風險 | 會不會破壞現有功能？ | | 維護風險 | 未來維護成本高嗎？ |

結論: [ ] 風險可控 / [ ] 中等風險需監控 / [ ] 高風險建議延後

---

診斷報告輸出格式

完成六問後，輸出以下摘要：

# 產品診斷報告

**專案**: {project-name}
**診斷日期**: {today}
**診斷人**: Tech Lead

## 診斷摘要

| # | 診斷問題 | 結論 | 備註 |
|---|---------|------|------|
| Q1 | 問題存在嗎？ | {結論} | {一句話說明} |
| Q2 | 目標用戶是誰？ | {結論} | {一句話說明} |
| Q3 | 解法合理嗎？ | {結論} | {一句話說明} |
| Q4 | 範圍明確嗎？ | {結論} | {一句話說明} |
| Q5 | 符合架構嗎？ | {結論} | {一句話說明} |
| Q6 | 風險可控嗎？ | {結論} | {一句話說明} |

## 總體建議

[ ] 建議通過 G0，可進入開發
[ ] 建議修改後再提交 G0（附修改建議）
[ ] 建議暫緩（附原因）
[ ] 建議取消（附原因）

## 修改建議（若有）

{具體的修改建議}

注意事項

• 此 Skill 僅產出診斷報告，不做任何程式碼修改
• 診斷結果呈報老闆，由老闆決定是否通過 G0
• 若多個問題結論為負面，強烈建議暫緩開發
• Q5 架構比對必須讀取實際文件，不可憑記憶回答

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Stanshy
• Source: Stanshy/AgentHub
• License: MIT
• Homepage: https://agenthub.stanshy.com/

Install and usage instructions live in the source repository linked above.