seo-brief-writer git:20260606.b0f0051A

Immutable. This exact content never changes and is served at /api/v1/blob/04fb7dd265c7fccb.

---
name: seo-brief-writer
sheetId: "1.21"
description: "SEO 流程第七棒：針對一個選定主題，找出價值主張與勝出關鍵，產出一份完整 SEO 寫作 Brief。對應 v2 流程圖「選擇主題：設計 Brief」。當使用者交出 Topics 交棒包、提供參考文章/論壇/專家意見、說「寫 Brief」時觸發。只寫 Brief，不設計大綱、不寫文章。"
category: brand-marketing
project: seo-brief-writer
platform: claude
status: WIP
author: Peter Tu
input: "seo-demand-validator 的 SEO_PACKET ▸ Topics；可選：參考文章/論壇問答/專家意見（文章資料包）"
process: "依 ceiling-article-features 分析天花板文章 → winning-key-scoring 找勝出關鍵與價值主張 → 套 brief-template 產出 Brief → 人工驗證並補充 → 交棒"
output: "一份 SEO 寫作 Brief，交給 seo-outline-designer"
synergy: ["seo-outline-designer"]
---

# SEO Brief Writer

```bash
npx skills add https://github.com/peter-tu-zynkr/zynkr-skill-builder --skill seo-brief-writer
```

SEO 流程第七棒，對應流程圖「找出價值主張和勝出關鍵 + 撰寫 Brief」。它先拆解該主題的「天花板文章」（SERP 最強者）有什麼特色，找出 Zynkr 要勝出的關鍵，再產出一份能直接餵給大綱與寫作的 Brief。

---

## Resources you'll use

> **知識來源**：本 skill 用到的 rubric/範本優先從 SEO Knowledge Base 的「01 Rubrics & Templates」(Drive，google-workspace MCP，依名稱 search) 讀取；取不到時 fallback 本地 `./references/`。對照表見 `seo-article-pipeline/seo-pipeline-config.md`。

- **天花板文章特色**：`./references/ceiling-article-features.md`
- **勝出關鍵審核表 / 評分表**：`./references/winning-key-scoring.md`
- **Brief 範本**：`./references/brief-template.md`
- **SEO 知識庫資料夾 ID**：`<your-seo-kb-folder-id>`；種子知識、第一手素材在 `02 Seed Knowledge` 子資料夾——`search_drive_files` 撈來支撐判斷

## Step 1 — 接收主題 + 參考素材

讀取 `SEO_PACKET ▸ Topics`，鎖定一個主題。若使用者提供參考文章 / 論壇問答 / 專家意見（文章資料包），納入分析。可用 `search_drive_files` 撈種子知識補第一手素材。

## Step 2 — 分析天花板文章

依 `./references/ceiling-article-features.md` 拆 SERP 最強的 2–3 篇：涵蓋點、結構、深度、缺口。

## Step 3 — 找勝出關鍵與價值主張

依 `./references/winning-key-scoring.md` 評分，定出本篇要靠什麼勝出（首重 decision-first 切角：sharper question + 真實 trade-off + 明確方向；第一手經驗為佐證），寫出一句價值主張。

## Step 4 — 產出 Brief

套 `./references/brief-template.md`：目標關鍵字、搜尋意圖、目標讀者（人物誌）、價值主張、勝出關鍵、必涵蓋點、第一手素材、CTA（B2B discovery 優先）、AEO 要求、語言（zh-TW + 是否旗艦 EN）。

## Step 5 — 人工驗證並補充（HITL）

對應「驗證並補充」。把 Brief 給使用者補第一手資訊 / 修正方向，確認後存檔。

## Step 6 — 交棒

```
SEO_PACKET ▸ Brief
<完整 Brief，依 brief-template 欄位>

Brief 已確認，可交棒給 seo-outline-designer 設計大綱與 FAQ。
```

## Outputs

一份 SEO 寫作 Brief（`SEO_PACKET ▸ Brief` + Drive 工作檔「SEO 撰寫 Brief」）。

## Limitations

不設計大綱（下一棒）、不寫文章。第一手素材不足時，標記 `[需 Peter 補]`，不杜撰案例。