git:20260606.b0f0051 to git:20260608.0b5a87c

21 added, 21 removed. Audit A to A.

---

name: seo-question-miner

sheetId: "1.16"

- description: "SEO 流程第二棒：根據人物誌，發想目標讀者「在購買前真正會問的問題」，並從問題反推種子關鍵字。對應 v2 流程圖「發想常見問題 + 訪談回答常見問題並列出關鍵字」。當使用者交出 persona 交棒包、說「發想常見問題」、「挖種子關鍵字」時觸發。只發想問題與種子字，不做難度分析、不寫文章。"

+ description: "Second leg of the SEO pipeline: based on the persona, brainstorm the questions your target readers actually ask before buying, then work backward from those questions to seed keywords. Maps to the v2 flowchart step 'brainstorm common questions + interview-answer common questions and list keywords'. Triggers when the user hands over the persona handoff packet or says '發想常見問題' or '挖種子關鍵字'. Only brainstorms questions and seed keywords; it does not do difficulty analysis and does not write articles."

category: brand-marketing

project: seo-question-miner

platform: claude

status: WIP

author: Peter Tu

- input: "seo-persona-builder 的 SEO_PACKET ▸ Persona 交棒包"

- process: "依 question-frames 從每個人物誌的痛點展開購買前問題（問題／比較／使用情境）→ 從問題反推種子關鍵字 → 人工審核 → 交棒"

- output: "分階段（TOFU/MOFU/BOFU）的買家問題清單 + 種子關鍵字，交給 seo-angle-finder"

+ input: "The SEO_PACKET ▸ Persona handoff packet from seo-persona-builder"

+ process: "Following question-frames, expand pre-purchase questions from each persona's pain points (problem / comparison / use case) → work backward from the questions to seed keywords → human review → handoff"

+ output: "A staged (TOFU/MOFU/BOFU) buyer-question list + seed keywords, handed off to seo-angle-finder"

synergy: ["seo-angle-finder"]

---

# SEO Question Miner

```bash

npx skills add https://github.com/peter-tu-zynkr/zynkr-skill-builder --skill seo-question-miner

```

- SEO 流程的第二棒。Neil Patel 的核心觀點：最好的關鍵字機會藏在「客戶購買前真正會問的問題」裡，而不是搜尋量表格。這個 skill 把人物誌的痛點展開成真實問句，再反推成種子關鍵字，餵給後面的關鍵字研究。

+ The second leg of the SEO pipeline. Neil Patel's core insight: the best keyword opportunities are hidden in "the questions customers actually ask before buying," not in a search-volume spreadsheet. This skill expands a persona's pain points into real questions, then works backward into seed keywords to feed the downstream keyword research.

---

## 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 used by this skill should be read first from the SEO Knowledge Base's "01 Rubrics & Templates" (Drive, google-workspace MCP, search by name); when unavailable, fall back to the local `./references/`. See the mapping table in `seo-article-pipeline/seo-pipeline-config.md`.

- - **問題展開框架**：`./references/question-frames.md`

- - **SEO 知識庫資料夾 ID**：`<your-seo-kb-folder-id>`（可選讀：Line 社群提問、support 信箱、種子知識）

- - **MCP server**：`google-workspace`

+ - **Question expansion framework**: `./references/question-frames.md`

+ - **SEO knowledge base folder ID**: `<your-seo-kb-folder-id>` (optional reads: Line community questions, support inbox, seed knowledge)

+ - **MCP server**: `google-workspace`

- ## Step 1 — 接收人物誌

+ ## Step 1 — Receive the persona

- 讀取上一棒的 `SEO_PACKET ▸ Persona`。若使用者未提供，請先要求或先跑 `seo-persona-builder`，**不提前展開**。

+ Read the `SEO_PACKET ▸ Persona` from the previous leg. If the user hasn't provided one, first ask for it or run `seo-persona-builder`; **do not expand ahead of time**.

- ## Step 2 — 展開購買前問題

+ ## Step 2 — Expand pre-purchase questions

- 針對每個人物誌，用 `./references/question-frames.md` 的四類框架（問題型、比較型、情境型、決策型）各展開數題，並標上漏斗階段 TOFU / MOFU / BOFU。可選：用 `search_drive_files` 在知識庫撈 Line 社群、support 真實提問補充。

+ For each persona, use the four frame types in `./references/question-frames.md` (problem, comparison, situational, decision) to expand several questions for each, and tag the funnel stage TOFU / MOFU / BOFU. Optional: use `search_drive_files` to pull real questions from the Line community and support in the knowledge base as supplementary material.

- ## Step 3 — 反推種子關鍵字

+ ## Step 3 — Work backward to seed keywords

- 每個問題對應 1–3 個口語化種子關鍵字（這是給下一棒丟進 Ubersuggest / AnswerThePublic 的起點，不是最終關鍵字）。

+ Each question maps to 1–3 conversational seed keywords (these are the starting point the next leg feeds into Ubersuggest / AnswerThePublic, not the final keywords).

- ## Step 4 — 人工審核（HITL）

+ ## Step 4 — Human review (HITL)

- 列出問題＋種子字，問使用者要保留／刪除哪些（編號）。對應流程圖「常見問題使用者審核以及同意」。

+ List the questions plus seed keywords and ask the user which to keep / delete (by number). Maps to the flowchart step "user reviews and approves the common questions."

- ## Step 5 — 交棒並存檔

+ ## Step 5 — Hand off and save

- 存入本篇工作子資料夾，輸出：

+ Save into this article's working subfolder, output:

```

SEO_PACKET ▸ Questions

- TOFU 問題：<...> ｜種子字：<...>

- MOFU 問題：<...> ｜種子字：<...>

- BOFU 問題：<...> ｜種子字：<...>

問題與種子關鍵字已確認，可交棒給 seo-angle-finder。

```

## Outputs

- 分階段買家問題清單 + 種子關鍵字（`SEO_PACKET ▸ Questions`）。

+ A staged buyer-question list + seed keywords (`SEO_PACKET ▸ Questions`).

## Limitations

- 不做搜尋量／難度分析（那是 seo-keyword-mapper / seo-demand-validator）。不寫文章。

+ Does not do search-volume / difficulty analysis (that's seo-keyword-mapper / seo-demand-validator). Does not write articles.