outline

name	outline
description	Smart Blog 大綱。生成 SERP 導向的文章大綱，分析搜尋結果前 5 名結構， 找出內容缺口。--full 可產出完整內容簡報（含關鍵字研究、競品分析、圖片規劃）。 Use when user says "outline blog", "大綱", "內容簡報", "blog outline", "smart-blog outline", "blog brief".
user-invokable	true
argument-hint	<主題> [--full]

Blog Outline — 大綱生成

工作流程

Step 1：確認主題

1. 主題 / 關鍵字
2. 搜尋意圖（教學 / 比較 / 排名 / 指南 / 案例）
3. 目標語言（預設：繁體中文）

模式判斷

• 預設模式：快速大綱（Step 1-7）
• --full 模式：完整內容簡報（加入 Step 3b、Step 5b、Step 8）

如果使用者說「簡報」「brief」「完整」或加了 --full，進入完整模式。

Step 2：Research Cache 檢查

1. 計算 slug
2. 用 Glob 檢查 docs/research/{slug}/competitors.md
3. 如果 cache 存在且未過期（查看 frontmatter stale_after）：
   • 讀取 cache 內容，跳過 SERP 搜尋（Step 3）
   • 直接使用 cache 的競品結構進入 Step 4（模板匹配）
4. 如果 cache 過期或不存在 → 進入 Step 3（SERP 分析）
5. --force-research flag → 忽略 cache，進入 Step 3

存檔更新： outline 完成後（Step 9），將 SERP 分析和競品結構存入 docs/research/{slug}/competitors.md

Step 3：SERP 分析

1. 用 WebSearch 搜尋主題關鍵字
2. 分析搜尋結果前 5 名：
   • 標題格式
   • H2/H3 結構（用 agent-browser 或 WebFetch 讀取）
   • 文章長度
   • 有沒有 FAQ
   • 有沒有表格/圖表
3. 整理共同的段落主題
4. 找出 內容缺口（競爭者沒涵蓋但讀者可能需要的）

Step 3b：關鍵字研究（--full 模式）

1. 用 WebSearch 搜尋關鍵字變體和長尾關鍵字
2. 分析搜尋意圖（資訊型 / 交易型 / 導航型）
3. 輸出：

類型	關鍵字	搜尋意圖
主要	[關鍵字]	[意圖]
長尾	[關鍵字 1]	[意圖]
長尾	[關鍵字 2]	[意圖]
長尾	[關鍵字 3]	[意圖]

Step 4：模板匹配

1. 讀取 skills/blog/references/content-templates.md
2. 根據搜尋意圖推薦模板
3. 告知使用者推薦的模板

Step 5：生成大綱

## 大綱：[主題]

**推薦模板：** [模板名稱]
**目標字數：** [N]-[N] 字
**搜尋意圖：** [教學/比較/排名/指南/案例]

---

### H1: [文章標題建議]

### 引言（150 字）
- Hook：[統計數字方向]
- 問題/機會陳述
- 文章預告

> TL;DR：[摘要方向]

### H2: [段落標題]（300 字）
- Answer-First：[需要什麼類型的統計]
- [要涵蓋的要點 1]
- [要涵蓋的要點 2]
- [圖片：建議圖片類型]

### H2: [段落標題]（300 字）
- Answer-First：[需要什麼類型的統計]
- [要涵蓋的要點]
- [圖表：建議圖表類型 + 數據方向]

### H2: [段落標題]（300 字）
- Answer-First：[需要什麼類型的統計]
- [要涵蓋的要點]

[... 更多 H2 段落 ...]

### FAQ（5 個問題）
1. [問題]？
2. [問題]？
3. [問題]？
4. [問題]？
5. [問題]？

### 結論（150 字）
- 重點整理
- CTA 方向
- [內部連結方向]

Step 5b：競品分析表（--full 模式）

分析 SERP 前 3-5 名：

排名	標題	字數	H2 數	有 FAQ	有圖表	差異化機會
1	[標題]	[N]	[N]	[Y/N]	[Y/N]	[描述]
2	[標題]	[N]	[N]	[Y/N]	[Y/N]	[描述]
...	...	...	...	...	...	...

Step 6：內容缺口報告

## 內容缺口分析

### 競爭者普遍涵蓋
- [主題 1]
- [主題 2]
- [主題 3]

### 競爭者缺少（我們的機會）
- [缺口 1] — [為什麼值得涵蓋]
- [缺口 2] — [為什麼值得涵蓋]
- [缺口 3] — [為什麼值得涵蓋]

### 建議差異化角度
[如何讓這篇文章與競爭者不同]

Step 7：E-E-A-T 規劃

## E-E-A-T 規劃

- **建議作者：** [根據主題推薦具備相關專業的作者]
- **經驗訊號：** [建議加入的第一人稱經驗描述方向]
- **原創性機會：** [可以做什麼原創研究或獨家數據]

Step 8：圖片規劃（預設模式）

根據文章大綱和 visual-media.md 的密度建議，為每張圖片產出：

欄位	說明
檔案名稱	[slug]-[序號]-[描述].webp，封面用 [slug]-cover.webp
放置位置	例如「封面」「引言之後」「H2: 合約類型 之後」
生成 Prompt	英文，適用 Midjourney / DALL-E / Flux，含風格、構圖、主題

輸出格式：

## 圖片規劃

| 檔案名稱 | 放置位置 | 生成 Prompt |
|---------|---------|------------|
| [slug]-cover.webp | 封面 / OG Image (1200×630) | [prompt] |
| [slug]-01-[desc].webp | 引言之後 | [prompt] |
| [slug]-02-[desc].webp | H2: [標題] 之後 | [prompt] |
| [slug]-03-[desc].webp | H2: [標題] 之後 | [prompt] |

Step 8b：連結與統計規劃（--full 模式）

統計數據搜尋方向

列出 8-12 個需要搜尋的統計方向：

1. [方向 + 建議搜尋查詢]
2. [方向 + 建議搜尋查詢] ...

內部連結規劃

• 建議連結密度：[N] 個（依目標字數）
• 連結放置位置：引言、H2 段落、FAQ、結論

Step 9：存檔

將所有分析結果存成 brief 文件：

存放路徑： docs/smart-blog/[slug].brief.md

• slug 規則：主題轉小寫、空白換成 -、移除特殊字元
• 範例：軟體開發合約注意什麼 → docs/smart-blog/software-development-contract.brief.md
• 繁體中文主題直接音譯或翻譯成英文 slug

文件格式：

---
topic: [主題]
keyword: [主要關鍵字]
intent: [搜尋意圖]
template: [模板名稱]
word-count: [建議字數範圍]
created: [YYYY-MM-DD]
status: draft
---

## 大綱
[Step 5 的完整大綱]

## 內容缺口分析
[Step 6 的報告]

## E-E-A-T 規劃
[Step 7 的規劃]

## 圖片規劃

| 檔案名稱 | 放置位置 | 生成 Prompt |
|---------|---------|------------|
| [slug]-cover.webp | 封面 / OG Image (1200×630) | [prompt] |
| [slug]-01-[desc].webp | 引言之後 | [prompt] |
| [slug]-02-[desc].webp | H2: [標題] 之後 | [prompt] |

## 關鍵字研究
[Step 3b 的表格，--full 模式才有]

## 競品分析
[Step 5b 的表格，--full 模式才有]

## 連結與統計規劃
[Step 8b 的內容，--full 模式才有]

6. 如果有 SERP 分析資料，同時存入 docs/research/{slug}/competitors.md

存檔完成後告知使用者路徑，並提示可執行 /smart-blog-skills:write [slug] 進入寫作流程。

---

呈現大綱給使用者確認。確認後存檔並提示進入 /smart-blog-skills:write 流程。 --full 模式下會同時呈現關鍵字研究、競品分析和視覺規劃。