seo-flow

FLOW 框架 — 发现 · 利用 · 优化 · 制胜

共享数据缓存

步骤 0 —— 检查共享数据缓存：

开始收集之前，请检查 .seo-cache/，查看是否有可从相关 SEO 技能复用的上下文。 参考：../seo/references/shared-data-cache.md，了解架构和依赖关系图。

检查以下缓存文件（如果存在）：

• .seo-cache/site-meta.json，了解域名、业务类型、行业和抓取上下文

• .seo-cache/audit-scores.json，了解之前完整审计的优先事项

• .seo-cache/pages/{url-slug}/page-analysis.json，在提供 URL 时了解页面级上下文

• 如果找到：解析并使用明显有效的字段（注明“正在使用缓存的 [X]，日期为 [date]”）

• 如果缺失、损坏或不相关：继续收集新证据

• 如果用户说“refresh”或“re-run”：忽略缓存读取，并在写入时覆盖

框架和提示词 © Daniel Agrici，CC BY 4.0 — github.com/AgriciDaniel/flow

FLOW 是一种以证据为导向、面向 AI 搜索时代的 SEO 运营模型。Codex SEO 集成了 FLOW 提示词库（涵盖 5 个阶段的 41 条提示词），让每项分析都能由结构化、有证据支撑的 AI 提示词驱动，而非依赖临时编写的查询。

运行时上下文： 每次激活 /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]	优化阶段：根据上下文从 21 条提示词中选择最相关的 2-3 条
/seo flow win [url]	制胜阶段：BOFU、转化率、双界面评分卡（3 条提示词）
/seo flow local [url]	本地阶段：GBP 优化、元数据、标题标签、本地审计（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. 运行：python scripts/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（任何子命令）时，分析前都要输出：

Framework and prompts © 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，然后重试。

写入共享数据缓存

完成所有工作后，如果工作流产生了可长期保留的发现，则将简洁的 JSON 摘要写入 .seo-cache/。 使用 ../seo/references/shared-data-cache.md 中的架构和命名规则；至少包含 cache_type、analyzed_at、来源 URL/域名、关键发现、问题、建议和工具限制。如果 .gitignore 中尚无 .seo-cache/，则将其添加进去。