102 lines
3.2 KiB
Markdown
102 lines
3.2 KiB
Markdown
---
|
||
name: report-writer
|
||
description: 報告格式化與存檔 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` |
|
||
|
||
## 報告通用格式
|
||
|
||
每份報告必須包含：
|
||
|
||
```markdown
|
||
# [報告標題]
|
||
|
||
| 欄位 | 內容 |
|
||
|------|------|
|
||
| 產出日期 | [YYYY-MM-DD] |
|
||
| 產出 Agent | [Agent 名稱] |
|
||
| 資料來源 | [主要搜尋/爬取來源] |
|
||
|
||
---
|
||
|
||
[報告正文]
|
||
|
||
---
|
||
|
||
## 資料來源清單
|
||
- [來源1]：[URL]
|
||
- [來源2]：[URL]
|
||
```
|
||
|
||
## 版本控制
|
||
|
||
- 初版存為原檔名
|
||
- 修改版存為 `[原檔名]-v2.md`（v3、v4 依次遞增）
|
||
- 每次修改在文件末尾的「變更記錄」中記錄
|
||
|
||
```markdown
|
||
## 變更記錄
|
||
| 版本 | 日期 | 變更說明 | 觸發指令 |
|
||
|------|------|---------|---------|
|
||
| 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 個 |
|