git:20260606.b0f0051 to git:20260608.0b5a87c

25 added, 25 removed. Audit A to A.

---
name: seo-brief-writer
sheetId: "1.21"
- description: "SEO 流程第七棒:針對一個選定主題,找出價值主張與勝出關鍵,產出一份完整 SEO 寫作 Brief。對應 v2 流程圖「選擇主題:設計 Brief」。當使用者交出 Topics 交棒包、提供參考文章/論壇/專家意見、說「寫 Brief」時觸發。只寫 Brief,不設計大綱、不寫文章。"
+ description: "Seventh stage of the SEO pipeline: for one selected topic, find the value proposition and winning angle, and produce a complete SEO writing Brief. Corresponds to the v2 flowchart step 「選擇主題:設計 Brief」. Triggers when the user hands over a Topics handoff packet, provides reference articles/forums/expert opinions, or says 「寫 Brief」. Only writes the Brief — does not design the outline and does not write the article."
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"
+ input: "The SEO_PACKET ▸ Topics from seo-demand-validator; optional: reference articles / forum Q&A / expert opinions (an article reference pack)"
+ process: "Analyze ceiling articles per ceiling-article-features → find the winning angle and value proposition per winning-key-scoring → apply brief-template to produce the Brief → human verification and augmentation → hand off"
+ output: "One SEO writing Brief, handed to 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。
+ Seventh stage of the SEO pipeline, corresponding to the flowchart step "find the value proposition and winning angle + write the Brief". It first breaks down what makes this topic's "ceiling article" (the strongest result on the SERP) work, identifies the key angle Zynkr needs to win on, then produces a Brief that can be fed directly into the outline and writing stages.
---
## 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`。
+ > **Knowledge source**: The rubrics/templates this skill uses should be read first from the SEO Knowledge Base's "01 Rubrics & Templates" (Drive, via the google-workspace MCP, search by name); if unavailable, fall back to the local `./references/`. See the mapping table in `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` 撈來支撐判斷
+ - **Ceiling article features**: `./references/ceiling-article-features.md`
+ - **Winning-angle review sheet / scoring sheet**: `./references/winning-key-scoring.md`
+ - **Brief template**: `./references/brief-template.md`
+ - **SEO Knowledge Base folder ID**: `<your-seo-kb-folder-id>`; seed knowledge and first-hand material live in the `02 Seed Knowledge` subfolder — use `search_drive_files` to pull it in to support your judgment
- ## Step 1 — 接收主題 + 參考素材
+ ## Step 1 — Receive the topic + reference material
- 讀取 `SEO_PACKET ▸ Topics`,鎖定一個主題。若使用者提供參考文章 / 論壇問答 / 專家意見(文章資料包),納入分析。可用 `search_drive_files` 撈種子知識補第一手素材。
+ Read `SEO_PACKET ▸ Topics` and lock onto one topic. If the user provides reference articles / forum Q&A / expert opinions (an article reference pack), fold them into the analysis. You can use `search_drive_files` to pull seed knowledge and supplement first-hand material.
- ## Step 2 — 分析天花板文章
+ ## Step 2 — Analyze the ceiling articles
- 依 `./references/ceiling-article-features.md` 拆 SERP 最強的 2–3 篇:涵蓋點、結構、深度、缺口。
+ Per `./references/ceiling-article-features.md`, dissect the 2–3 strongest results on the SERP: coverage points, structure, depth, gaps.
- ## Step 3 — 找勝出關鍵與價值主張
+ ## Step 3 — Find the winning angle and value proposition
- 依 `./references/winning-key-scoring.md` 評分,定出本篇要靠什麼勝出(首重 decision-first 切角:sharper question + 真實 trade-off + 明確方向;第一手經驗為佐證),寫出一句價值主張。
+ Score per `./references/winning-key-scoring.md` and decide what this piece will win on (prioritize a decision-first angle: a sharper question + real trade-offs + a clear recommendation; first-hand experience as supporting evidence), then write a one-sentence value proposition.
- ## Step 4 — 產出 Brief
+ ## Step 4 — Produce the Brief
- 套 `./references/brief-template.md`:目標關鍵字、搜尋意圖、目標讀者(人物誌)、價值主張、勝出關鍵、必涵蓋點、第一手素材、CTA(B2B discovery 優先)、AEO 要求、語言(zh-TW + 是否旗艦 EN)。
+ Apply `./references/brief-template.md`: target keyword, search intent, target reader (persona), value proposition, winning angle, must-cover points, first-hand material, CTA (B2B discovery first), AEO requirements, language (zh-TW + whether a flagship EN version is needed).
- ## Step 5 — 人工驗證並補充(HITL)
+ ## Step 5 — Human verification and augmentation (HITL)
- 對應「驗證並補充」。把 Brief 給使用者補第一手資訊 / 修正方向,確認後存檔。
+ Corresponds to "verify and augment". Give the Brief to the user to add first-hand information / correct the direction, and save it once confirmed.
- ## Step 6 — 交棒
+ ## Step 6 — Hand off
```
SEO_PACKET ▸ Brief
- <完整 Brief,依 brief-template 欄位>
+ <complete Brief, per the brief-template fields>
- Brief 已確認,可交棒給 seo-outline-designer 設計大綱與 FAQ。
+ Brief confirmed; ready to hand off to seo-outline-designer to design the outline and FAQ.
```
## Outputs
- 一份 SEO 寫作 Brief(`SEO_PACKET ▸ Brief` + Drive 工作檔「SEO 撰寫 Brief」)。
+ One SEO writing Brief (`SEO_PACKET ▸ Brief` + the Drive working file "SEO 撰寫 Brief").
## Limitations
- 不設計大綱(下一棒)、不寫文章。第一手素材不足時,標記 `[需 Peter 補]`,不杜撰案例。
+ Does not design the outline (next stage), does not write the article. When first-hand material is insufficient, mark `[需 Peter 補]` rather than fabricating cases.