seo-flow

FLOW 框架：發現 · 槓桿 · 優化 · 勝出

FLOW 是一個為 AI 搜尋時代打造的證據導向 SEO 運作模型。Claude SEO 整合了 FLOW 提示庫（5 個階段共 41 個提示），讓每次分析都能由結構化、有證據支持的 AI 提示驅動，而非臨時提問。

框架與提示 © Daniel Agrici, CC BY 4.0：github.com/AgriciDaniel/flow

執行時期上下文： 每次啟用 /seo flow 時載入 references/flow-framework.md。僅在使用者要求特定階段時，才按需求載入提示檔案。

---

指令

指令	功能
/seo flow	顯示 FLOW 總覽 + 階段選單
/seo flow find [url|topic]	發現階段：關鍵字研究、差距分析、SERP 意圖對應（5 個提示）
/seo flow leverage [url]	槓桿階段：反向連結策略、站外權威（1 個提示）
/seo flow optimize [url]	優化階段：根據上下文選取 2-3 個最相關的提示（共 21 個）
/seo flow win [url]	勝出階段：BOFU、轉換率、雙面評分卡（3 個提示）
/seo flow local [url]	本地階段：GBP 優化、Meta、標題標籤、本地稽核（11 個提示）
/seo flow prompts	全部 41 個提示的完整索引（階段、名稱、觸發條件）
/seo flow sync	從 github.com/AgriciDaniel/flow 拉取最新提示檔案

---

編排邏輯

執行 /seo flow（無子指令）

1. 讀取 references/flow-framework.md
2. 顯示 FLOW 階段總覽，每個階段附一行說明
3. 詢問：哪個階段符合使用者當前情況？

執行 /seo flow find [url|topic]

1. 讀取 references/prompts/find/ 中的所有檔案
2. 將每個提示應用於該 URL 或主題
3. 交叉參考：「如需更深入的 SERP 分群，請參閱 /seo cluster <seed-keyword>」

執行 /seo flow leverage [url]

1. 讀取 references/prompts/leverage/ 中的檔案
2. 應用於該 URL 當前的反向連結上下文
3. 交叉參考：「如需原始反向連結資料，請參閱 /seo backlinks <url>」

執行 /seo flow optimize [url]

1. 讀取 references/prompts/optimize/ 中的所有檔案名稱
2. 讀取先前的分析上下文（URL、產業垂直、對話中任何先前的技能輸出）
3. 選取 2-3 個最相關的提示；僅載入這些檔案
4. 應用所選提示；註明其他提示可透過 /seo flow prompts 存取
5. 交叉參考：「如需完整的內容品質分析，請參閱 /seo content <url> 和 /seo geo <url>」

執行 /seo flow win [url]

1. 讀取 references/prompts/win/ 中的所有檔案
2. 將每個提示應用於該 URL 的轉換和 BOFU 上下文
3. 交叉參考：「如需 SXO 人物角色評分，請參閱 /seo sxo <url>」

執行 /seo flow local [url]

1. 讀取 references/prompts/local/ 中的所有檔案
2. 應用於該 URL 的本地 SEO 上下文
3. 交叉參考：「如需完整的本地 SEO 分析，請參閱 /seo local <url> 和 /seo maps [command]」

執行 /seo flow prompts

1. 讀取 references/prompts/README.md
2. 顯示完整索引：全部 41 個提示，包含階段、名稱、觸發條件

執行 /seo flow sync

1. 執行：claude-seo run sync_flow.py
2. 顯示 JSON 摘要（新增、更新、未變更的檔案）
3. 同步完成後顯示出處聲明

---

上下文匹配（優化階段）

優化階段有 21 個提示。全部列出會造成資訊過載。請依優先順序選取：

1. 產業垂直（SaaS → 頁面內 + 技術；本地 → 引用 + GBP；出版商 → E-E-A-T + 新鮮度）
2. 先前的技能輸出（seo-technical 標記爬蟲問題 → 技術優化提示；seo-content 標記 E-E-A-T 差距 → 內容優化提示）
3. URL 訊號（產品頁面 → 轉換；部落格 → 新鮮度 + 權威性）

務必只呈現 2-3 個提示。說明你選擇了哪些提示及其原因。

---

參考檔案

按需求載入，不要在啟動時全部載入：

• references/flow-framework.md：FLOW 運作模型（每次啟用 /seo flow 時載入）
• references/bibliography.md：證據來源；引用研究或統計資料時載入
• references/prompts/README.md：提示索引；用於 /seo flow prompts
• references/prompts/find/：5 個提示；用於 /seo flow find
• references/prompts/leverage/：1 個提示；用於 /seo flow leverage
• references/prompts/optimize/：21 個提示；選擇性載入用於 /seo flow optimize
• references/prompts/win/：3 個提示；用於 /seo flow win
• references/prompts/local/：11 個提示；用於 /seo flow local

---

出處聲明

每次啟用 /seo flow（任何子指令）時，在分析前輸出：

框架與提示 © Daniel Agrici, CC BY 4.0：github.com/AgriciDaniel/flow

不得省略或修改出處聲明。

---

錯誤處理

情境	處理方式
references/flow-framework.md 遺失	「FLOW 參考檔案未同步。請執行：/seo flow sync」
提示檔案遺失	「請執行 /seo flow sync 以從 FLOW 儲存庫拉取最新提示。」
sync_flow.py 網路錯誤	顯示腳本的 stderr。檢查速率限制：gh api rate_limit。
sync_flow.py 驗證錯誤	執行 gh auth login 後重試。