daniel.w
/
claude-code
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
claude-code/.claude/skills/report-writer/SKILL.md

3.2 KiB
Raw Blame History

name description
report-writer 報告格式化與存檔 Skill。定義各類研究報告的 Markdown 模板、存檔路徑規範、版本控制策略。

Report Writer Skill

統一所有 PM 產出的報告格式，確保一致性、可追溯性，並規範存檔路徑。

存檔路徑規範

所有報告存入 docs/prd/drafts/[產品名稱]-[YYYY-MM-DD]/ 目錄：

報告類型 檔名
市場研究報告 01-market-research.md
競品分析報告 02-competitor-analysis.md
用戶洞察報告 03-user-insights.md
旅程與策略報告 04-journey-strategy.md
優先級與 Roadmap 05-prioritization.md
最終 PRD ../[產品名]-prd-[YYYY-MM-DD].md

報告通用格式

每份報告必須包含：

# [報告標題]

| 欄位 | 內容 |
|------|------|
| 產出日期 | [YYYY-MM-DD] |
| 產出 Agent | [Agent 名稱] |
| 資料來源 | [主要搜尋/爬取來源] |

---

[報告正文]

---

## 資料來源清單
- [來源1]：[URL]
- [來源2]：[URL]

版本控制

  • 初版存為原檔名
  • 修改版存為 [原檔名]-v2.md（v3、v4 依次遞增）
  • 每次修改在文件末尾的「變更記錄」中記錄
## 變更記錄
| 版本 | 日期 | 變更說明 | 觸發指令 |
|------|------|---------|---------|
| v1.0 | [日期] | 初始版本 | /pm |
| v1.1 | [日期] | [修改說明] | /pm-edit |

存檔後回報格式

每次存檔完成後，必須回傳：

✅ [報告類型] 已存至 [完整路徑]

PRD 模板摘要與格式規範

最終 PRD 除了基礎業務邏輯外，必須強制包含以下結構（詳見 pm-writer agent）：

  1. TL;DR
  2. 背景與為什麼要做（Why）
  3. 目標與成功指標
  4. 目標用戶與使用情境
  5. 功能性需求 (Functional Requirements)
    • 必須以模組 (Module) 與 子模組 (Sub-module) 分層撰寫 (如 ## 帳號體系 -> ### 註冊)
    • 針對每個獨立功能，必須包含以下 4 個標準區塊：
      1. 流程與交互圖：使用 mermaid 語法繪製流程圖 (Flowchart)、時序圖 (Sequence Diagram) 或狀態機圖。
      2. 邊界條件與異常處理 (Edge Cases)：使用表格詳列「情況/錯誤」、「觸發條件」與「處理邏輯與回應」。
      3. 業務邏輯描述：使用條列式 (Bullet points) 清楚說明功能規則。
      4. 介面與資料欄位 (Data Fields)：使用表格定義欄位，包含 字段名(zh-Tw)、Name(en-Us)、資料型態、說明。
      5. (可選) EARS 驗收標準
  6. 通知系統 (Notifications)：統一收斂所有會觸發的 SMS/Mail/Push 規則，以表格呈現 (觸發條件、通道、對象)。
  7. 非功能性需求 (Non-functional Requirements)：必須定義：安全性、支援地區、時區 (如 UTC+8)、多語系支援 (附上 ISO 639-1 代碼)、效能與併發要求。
  8. 用戶旅程
  9. 產品 Roadmap
  10. 資源估算
  11. 風險與假設
  12. 附錄（來源清單 + 變更記錄）

品質底線

項目 最低標準
Must Have 功能 ≥ 8 個
用戶痛點 ≥ 8 個具體痛點
競品數量 ≥ 3 個有完整分析
風險清單 ≥ 5 個（High/Medium/Low）
開放問題 ≥ 3 個