blog-flow

面向博主的 FLOW 框架（发现、优化、制胜）

FLOW 是一个以证据为导向、为 AI 搜索时代打造的运营模型。Claude Blog 集成了 FLOW 提示词库，让写作者可以使用结构化、以来源为依据的 AI 提示词来驱动工作流，而不是临时编写查询。

此技能提供与博客相关的三个阶段（发现、优化、制胜），并通过提示词索引提供单个杠杆提示词。当地 SEO 提示词（GBP、引文、本地审计）专为实体店运营而设计，并不适用于博客，因此特意排除。

运行时上下文。 每次激活 /blog flow 时都加载 references/flow-framework.md。仅在需要时加载提示词文件，并限定在用户请求的阶段内。

---

命令

命令	功能
/blog flow	显示 FLOW 概览和阶段菜单
/blog flow find [topic|url]	发现阶段：关键词发现、意图映射、差距分析（5 个提示词）
/blog flow optimize [url]	优化阶段：根据上下文，从 21 个提示词中选出 2 到 3 个最相关的提示词
/blog flow win [url]	制胜阶段：BOFU、转化、双表面评分卡（3 个提示词）
/blog flow prompts	显示全部 30 个适用于博客的提示词索引（发现、杠杆、优化、制胜）
/blog flow sync	从 github.com/AgriciDaniel/flow 拉取最新提示词文件

单个杠杆提示词（站外权威性）可通过 /blog flow prompts 访问，不会作为顶级命令推广，因为大多数博客工作流会在其他地方处理站外工作。

---

编排逻辑

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

1. 读取 references/flow-framework.md。
2. 显示 FLOW 阶段概览，并用一句话描述每个阶段。
3. 询问用户目前的情况适合哪个阶段。

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

1. 读取 references/prompts/find/ 中的所有文件。
2. 将每个提示词应用于主题或 URL，捕捉需求和意图信号。
3. 交叉引用：“如需更深入的简报和大纲，请参阅 /blog brief <topic>、/blog outline <topic> 和 /blog cannibalization，以检测与现有文章的重叠。”

执行 /blog flow optimize [url] 时

1. 读取 references/prompts/optimize/ 中的文件名。
2. 读取先前上下文（目标 URL、领域、本次对话中任何先前技能的输出、/blog analyze 的评分变化）。
3. 选出 2 到 3 个最相关的提示词，然后仅加载这些文件。
4. 应用选中的提示词；注明其余提示词可通过 /blog flow prompts 访问。
5. 交叉引用：“如需更深入的改写和验证，请参阅 /blog rewrite <file>、/blog seo-check <file>、/blog geo <file>、/blog schema <file> 和 /blog factcheck <file>。”

执行 /blog flow win [url] 时

1. 读取 references/prompts/win/ 中的所有文件。
2. 将每个提示词应用于该 URL 的转化和 BOFU 上下文。
3. 交叉引用：“如需内容再利用、全站健康度检查和质量评分，请参阅 /blog repurpose <file>、/blog audit 和 /blog analyze <file>。”

执行 /blog flow prompts 时

1. 读取 references/prompts/README.md。
2. 显示完整索引：按阶段（发现、杠杆、优化、制胜）分组的 30 个提示词，以及名称和触发条件。
3. 说明当地 SEO 提示词是有意排除的；如需使用，请引导用户前往 claude-seo（/seo flow local）。

执行 /blog flow sync 时

1. 运行：python3 scripts/sync_flow.py。
2. 显示 JSON 摘要（新增、更新、未更改的文件）。
3. 同步完成后显示署名声明。

---

上下文匹配（优化阶段）

优化阶段有 21 个提示词。全部列出会造成干扰。按优先级筛选：

1. 细分领域（SaaS 或 B2B 博客侧重页面优化和技术优化；生活方式类内容侧重时效性和 E-E-A-T；出版商侧重权威性和引用）。
2. 先前技能的输出（/blog analyze 的 E-E-A-T 差距对应权威性提示词；/blog seo-check 的失败项对应页面优化提示词；/blog geo 的差距对应内容提取格式提示词）。
3. URL 信号（商业页面需要转化提示词；信息类文章需要时效性和答案优先提示词）。

始终准确展示 2 到 3 个提示词。说明你选择了哪些提示词以及原因。

---

参考文件

按需加载。启动时不要全部加载。

• references/flow-framework.md。FLOW 运作模型。每次激活 /blog flow 时加载。
• references/bibliography.md。证据来源。引用研究或统计数据时加载。
• references/prompts/README.md。提示词索引。用于 /blog flow prompts 时加载。
• references/prompts/find/。5 个提示词。用于 /blog flow find 时加载。
• references/prompts/leverage/。1 个提示词。仅在通过 /blog flow prompts 展示时加载。
• references/prompts/optimize/。21 个提示词。用于 /blog flow optimize 时按需选择性加载。
• references/prompts/win/。3 个提示词。用于 /blog flow win 时加载。

如果缺少 references/，请指示用户先运行 /blog flow sync。

---

同步脚本

scripts/sync_flow.py 会从 github.com/AgriciDaniel/flow 获取提示词文件，并写入 skills/blog-flow/references/。仅使用标准库和 HTTPS；仅允许访问 api.github.com；响应大小上限为 5 MB；采用原子写入；并防范路径遍历。

模式：

• python3 scripts/sync_flow.py。将每个与博客相关阶段的最新版本同步到磁盘，并刷新锁定文件。
• python3 scripts/sync_flow.py --dry-run。报告计划进行的更改，不写入文件。
• python3 scripts/sync_flow.py --ref <sha>。将获取内容固定到特定的 FLOW 提交 SHA，以便可复现地安装。

锁定文件位于 skills/blog-flow/references/flow-prompts.lock，采用兼容 sha256sum 的格式。每次同步运行时都会报告磁盘内容与锁定文件之间的偏差。

该脚本仅同步适用于博客的阶段（find、leverage、optimize、win）。为使 references 目录与技能的范围保持一致，脚本有意跳过 local 阶段。

GitHub API 调用默认匿名进行。如果环境中设置了 GITHUB_TOKEN，或在收到 403 响应后 gh auth token 返回了令牌，脚本会使用该令牌重试请求。不会将令牌写入磁盘。

请勿省略或修改署名信息。同步的文件还会带有同步脚本注入的 HTML 注释许可声明。

---

错误处理

情况	操作
缺少 references/flow-framework.md	“FLOW 参考文件尚未同步。请运行：/blog flow sync。”
缺少提示词文件	“运行 /blog flow sync，从 FLOW 仓库获取最新提示词。”
sync_flow.py 网络错误	显示脚本的 stderr。如果已安装 gh，请使用 gh api rate_limit 检查速率限制。
sync_flow.py 重试后仍返回 403	设置 GITHUB_TOKEN 或运行 gh auth login，然后重试。
路径遍历中止	同步目标尝试逃逸出 references 目录。请检查上游仓库，并固定到已知良好的 --ref。