Back to Details

seo-flow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

FLOW Framework — Find · Leverage · Optimize · Win

FLOW Framework — 发现·利用·优化·制胜

Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
FLOW is an evidence-led SEO operating model built for the AI-search era. Claude SEO integrates the FLOW prompt library (41 prompts across 5 stages) so every analysis can be driven by structured, evidence-backed AI prompts rather than improvised queries.
Runtime context: Load 
references/flow-framework.md
on every 
/seo flow
activation. Load prompt files on demand — only for the stage the user requests.
Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
FLOW是专为AI搜索时代打造的循证SEO运营模型。Claude SEO集成了FLOW提示词库（涵盖5个阶段的41个提示词），让每一项分析都由结构化、有循证支持的AI提示词驱动，而非临时拼凑的查询语句。
运行时上下文： 每次激活
/seo flow
时加载
references/flow-framework.md
。按需加载提示词文件——仅加载用户请求的阶段对应的文件。

Commands

命令

CommandWhat it does
/seo flow
Show FLOW overview + stage menu
/seo flow find [url|topic]
Find-stage: keyword research, gap analysis, SERP intent mapping (5 prompts)
/seo flow leverage [url]
Leverage-stage: backlink strategy, off-site authority (1 prompt)
/seo flow optimize [url]
Optimize-stage: select 2-3 most relevant of 21 prompts based on context
/seo flow win [url]
Win-stage: BOFU, conversion rate, dual-surface scorecard (3 prompts)
/seo flow local [url]
Local-stage: GBP optimization, meta, title tags, local audits (11 prompts)
/seo flow prompts
Full index of all 41 prompts — stage, name, trigger conditions
/seo flow sync
Pull latest prompt files from github.com/AgriciDaniel/flow
命令功能
/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优化、元标签、标题标签、本地审计（11个提示词）
/seo flow prompts
所有41个提示词的完整索引——包含阶段、名称、触发条件
/seo flow sync
从github.com/AgriciDaniel/flow拉取最新提示词文件

Orchestration Logic

编排逻辑

On 
/seo flow
(no sub-command)

执行
/seo flow
（无子命令）时

  1. Read 
    references/flow-framework.md
  2. Show the FLOW stage overview with a one-line description of each stage
  3. Ask: which stage matches the user's current situation?
  1. 读取
    references/flow-framework.md
    文件
  2. 展示FLOW各阶段概览及每个阶段的单行描述
  3. 询问：哪个阶段符合用户当前的情况？

On 
/seo flow find [url|topic]

执行
/seo flow find [url|topic]
时

  1. Read all files in 
    references/prompts/find/
  2. Apply each prompt to the URL or topic
  3. Cross-reference: "For deeper SERP clustering, see 
    /seo cluster <seed-keyword>
    "
  1. 读取
    references/prompts/find/
    目录下的所有文件
  2. 将每个提示词应用于指定URL或主题
  3. 交叉引用：“如需更深入的SERP聚类分析，请查看
    /seo cluster <seed-keyword>
    ”

On 
/seo flow leverage [url]

执行
/seo flow leverage [url]
时

  1. Read the file in 
    references/prompts/leverage/
  2. Apply to the URL's current backlink context
  3. Cross-reference: "For raw backlink data, see 
    /seo backlinks <url>
    "
  1. 读取
    references/prompts/leverage/
    目录下的文件
  2. 将提示词应用于该URL当前的反向链接上下文
  3. 交叉引用：“如需原始反向链接数据，请查看
    /seo backlinks <url>
    ”

On 
/seo flow optimize [url]

执行
/seo flow optimize [url]
时

  1. Read all file names in 
    references/prompts/optimize/
  2. Read prior analysis context (URL, industry vertical, any prior skill output in conversation)
  3. Select 2-3 most relevant prompts; load only those files
  4. Apply selected prompts; note the others are accessible via 
    /seo flow prompts
  5. Cross-reference: "For full content quality analysis, see 
    /seo content <url>
    and 
    /seo geo <url>
    "
  1. 读取
    references/prompts/optimize/
    目录下的所有文件名
  2. 读取历史分析上下文（URL、行业垂直领域、对话中任何之前的技能输出）
  3. 选择2-3个最相关的提示词；仅加载这些文件
  4. 应用选中的提示词；说明其他提示词可通过
    /seo flow prompts
    获取
  5. 交叉引用：“如需完整的内容质量分析，请查看
    /seo content <url>
    和
    /seo geo <url>
    ”

On 
/seo flow win [url]

执行
/seo flow win [url]
时

  1. Read all files in 
    references/prompts/win/
  2. Apply each prompt to the URL's conversion and BOFU context
  3. Cross-reference: "For SXO persona scoring, see 
    /seo sxo <url>
    "
  1. 读取
    references/prompts/win/
    目录下的所有文件
  2. 将每个提示词应用于该URL的转化及BOFU上下文
  3. 交叉引用：“如需SXO角色评分，请查看
    /seo sxo <url>
    ”

On 
/seo flow local [url]

执行
/seo flow local [url]
时

  1. Read all files in 
    references/prompts/local/
  2. Apply to the URL's local SEO context
  3. Cross-reference: "For full local SEO analysis, see 
    /seo local <url>
    and 
    /seo maps [command]
    "
  1. 读取
    references/prompts/local/
    目录下的所有文件
  2. 将提示词应用于该URL的本地SEO上下文
  3. 交叉引用：“如需完整的本地SEO分析，请查看
    /seo local <url>
    和
    /seo maps [command]
    ”

On 
/seo flow prompts

执行
/seo flow prompts
时

  1. Read 
    references/prompts/README.md
  2. Display the full index: all 41 prompts with stage, name, trigger conditions
  1. 读取
    references/prompts/README.md
    文件
  2. 展示完整索引：所有41个提示词及其所属阶段、名称、触发条件

On 
/seo flow sync

执行
/seo flow sync
时

  1. Run: 
    python scripts/sync_flow.py
  2. Display the JSON summary (files added, updated, unchanged)
  3. Show attribution notice after sync completes
  1. 运行：
    python scripts/sync_flow.py
  2. 展示JSON汇总（新增、更新、未变更的文件）
  3. 同步完成后显示版权声明

Context Matching (Optimize stage)

上下文匹配（优化阶段）

The optimize stage has 21 prompts. Dumping all 21 is noise. Select by priority:
  1. Industry vertical (SaaS → on-page + technical; local → citations + GBP; publisher → E-E-A-T + freshness)
  2. Prior skill output (seo-technical flagged crawl issues → technical optimize prompts; seo-content flagged E-E-A-T gaps → content optimize prompts)
  3. URL signals (product pages → conversion; blog → freshness + authority)
Always surface exactly 2-3 prompts. State which prompts you chose and why.
优化阶段包含21个提示词。全部输出会造成信息冗余，需按优先级选择：
  1. 行业垂直领域（SaaS → 页面内优化+技术优化；本地商家 → 引用+GBP优化；内容发布商 → E-E-A-T+内容新鲜度）
  2. 历史技能输出（seo-technical标记了爬取问题 → 技术优化提示词；seo-content标记了E-E-A-T差距 → 内容优化提示词）
  3. URL信号（产品页面 → 转化优化；博客页面 → 新鲜度+权威性优化）
始终仅展示2-3个提示词，并说明选择这些提示词的原因。

Reference Files

参考文件

Load on-demand — do NOT load all at startup:
  • references/flow-framework.md
    — FLOW operating model (load on every 
    /seo flow
    activation)
  • references/bibliography.md
    — Evidence sources; load when citing studies or statistics
  • references/prompts/README.md
    — Prompt index; load for 
    /seo flow prompts
  • references/prompts/find/
    — 5 prompts; load for 
    /seo flow find
  • references/prompts/leverage/
    — 1 prompt; load for 
    /seo flow leverage
  • references/prompts/optimize/
    — 21 prompts; load selectively for 
    /seo flow optimize
  • references/prompts/win/
    — 3 prompts; load for 
    /seo flow win
  • references/prompts/local/
    — 11 prompts; load for 
    /seo flow local
按需加载——请勿在启动时全部加载：
  • 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
    时加载

Attribution

版权声明

Every 
/seo flow
activation (any sub-command) outputs before analysis:
Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
Do not omit or modify the attribution.
每次激活
/seo flow
（任何子命令）时，需在分析前输出：
Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
请勿省略或修改该版权声明。

Error Handling

错误处理

ScenarioAction
references/flow-framework.md
missing		"FLOW reference files not synced. Run: 
/seo flow sync
"
Prompt file missing"Run 
/seo flow sync
to pull the latest prompts from the FLOW repo."
sync_flow.py
network error		Display the script's stderr. Check rate limits: 
gh api rate_limit
.
sync_flow.py
auth error		Run 
gh auth login
then retry.
场景操作
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
后重试。