Agent SkillsStanshy/AgentHub › product-diagnosis

product-diagnosis

GitHub

六問產品診斷框架,在開發前驗證G0提案品質。涵蓋問題存在性、用戶定義、解法合理性、範圍明確度、架構一致性與風險評估,確保方向正確後再進入實作階段。

.knowledge/company/skill-templates/product-diagnosis/SKILL.md Stanshy/AgentHub

Trigger Scenarios

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

Install

npx skills add Stanshy/AgentHub --skill product-diagnosis -g -y
More Options

Non-standard path

npx skills add https://github.com/Stanshy/AgentHub/tree/main/.knowledge/company/skill-templates/product-diagnosis -g -y

Use without installing

npx skills use Stanshy/AgentHub@product-diagnosis

指定 Agent (Claude Code)

npx skills add Stanshy/AgentHub --skill product-diagnosis -a claude-code -g -y

安装 repo 全部 skill

npx skills add Stanshy/AgentHub --all -g -y

预览 repo 内 skill

npx skills add Stanshy/AgentHub --list

SKILL.md

Frontmatter
{
    "name": "product-diagnosis",
    "description": "Six-question diagnostic framework for G0 pre-check — validate product direction before development starts",
    "allowed-tools": "Read, Glob, Grep"
}

產品診斷(G0 前置檢查)

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

使用方式

/product-diagnosis <project-name>

參數

  • $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 架構比對必須讀取實際文件,不可憑記憶回答

Version History

  • 5300820 Current 2026-07-24 12:11

Same Skill Collection

.knowledge/company/skill-templates/dev-plan/SKILL.md
.knowledge/company/skill-templates/gate-record/SKILL.md
.knowledge/company/skill-templates/harness-audit/SKILL.md
.knowledge/company/skill-templates/knowledge-feedback/SKILL.md
.knowledge/company/skill-templates/pitfall-record/SKILL.md
.knowledge/company/skill-templates/pitfall-resolve/SKILL.md
.knowledge/company/skill-templates/pm-review/SKILL.md
.knowledge/company/skill-templates/project-kickoff/SKILL.md
.knowledge/company/skill-templates/review/SKILL.md
.knowledge/company/skill-templates/sop-deploy/SKILL.md
.knowledge/company/skill-templates/sop-review/SKILL.md
.knowledge/company/skill-templates/sprint-close/SKILL.md
.knowledge/company/skill-templates/sprint-proposal/SKILL.md
.knowledge/company/skill-templates/sprint-retro/SKILL.md
.knowledge/company/skill-templates/task-delegation/SKILL.md
.knowledge/company/skill-templates/task-dispatch/SKILL.md
.knowledge/company/skill-templates/task-done/SKILL.md
.knowledge/company/skill-templates/task-start/SKILL.md
.knowledge/company/skill-templates/task-status/SKILL.md
.knowledge/company/skill-templates/pre-deploy/SKILL.md
.knowledge/company/skill-templates/sop-execute/SKILL.md
.knowledge/company/skill-templates/sop-plan/SKILL.md
.knowledge/company/skill-templates/spec-update/SKILL.md
.knowledge/company/skill-templates/task-approve/SKILL.md

Metadata

Files
0
Version
5300820
Hash
bc44512f
Indexed
2026-07-24 12:11

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-07 02:35
浙ICP备14020137号-1 $방문자$