SuperAPI AI 工具集

blog-flow

写作与研究

查看项目

更新于 10-16 09:00

技能介绍

FLOW Framework for Bloggers(Find、Optimize、Win)

FLOW 是面向 AI 搜索时代、以证据为导向的运营模型。Claude Blog 集成了 FLOW 提示库,使写作者能够用结构化、有来源支撑的 AI 提示驱动工作流,而不是临时拼凑查询。

本技能暴露三个与博客相关的阶段(Find、Optimize、Win),并通过提示索引保留单个 Leverage 提示。本地 SEO 提示(GBP、引用、本地审计)被有意排除,因为它们面向实体店业务,而非博客。

运行时上下文:每次激活 /blog flow 时加载 references/flow-framework.md;提示文件按需加载,仅限用户请求的阶段。

命令

  • /blog flow:显示 FLOW 概览与阶段菜单。
  • /blog flow find [topic|url]:Find 阶段,进行关键词发现、意图映射、缺口分析(5 个提示)。
  • /blog flow optimize [url]:Optimize 阶段,根据上下文从 21 个提示中选择 2 到 3 个最相关的提示。
  • /blog flow win [url]:Win 阶段,处理 BOFU、转化、双面记分卡(3 个提示)。
  • /blog flow prompts:全部 30 个适用于博客的提示索引(Find、Leverage、Optimize、Win)。
  • /blog flow sync:从 github.com/AgriciDaniel/flow 拉取最新提示文件。

单个 Leverage 提示(站外权威)可通过 /blog flow prompts 访问,但不提升为顶层命令,因为多数博客工作流会把站外工作导向别处。

编排逻辑

在 /blog flow(无子命令)时:读取 references/flow-framework.md;显示 FLOW 阶段概览及各阶段一行说明;询问用户当前情况匹配哪个阶段。

在 /blog flow find [topic|url] 时:读取 references/prompts/find/ 下所有文件;对主题或 URL 应用每个提示,捕获需求与意图信号;交叉引用提示“如需更深入的简报和大纲,参见 /blog brief <topic>、/blog outline <topic> 与 /blog cannibalization 以检测与现有文章的重复。”

在 /blog flow optimize [url] 时:读取 references/prompts/optimize/ 中的文件名;读取先前上下文(目标 URL、细分领域、本对话中先前技能输出、来自 /blog analyze 的评分变化);选取 2 到 3 个最相关提示,然后只加载这些文件;应用所选提示,并说明其余提示可通过 /blog flow prompts 访问;交叉引用提示“如需更深入的重写与验证,参见 /blog rewrite <file>、/blog seo-check <file>、/blog geo <file>、/blog schema <file> 与 /blog factcheck <file>。”

在 /blog flow win [url] 时:读取 references/prompts/win/ 下所有文件;对 URL 的转化与 BOFU 上下文应用每个提示;交叉引用提示“如需内容再利用、全站健康与质量评分,参见 /blog repurpose <file>、/blog audit 与 /blog analyze <file>。”

在 /blog flow prompts 时:读取 references/prompts/README.md;显示完整索引,即 30 个提示按阶段(Find、Leverage、Optimize、Win)分组,含名称与触发条件;说明本地 SEO 提示按设计排除,若用户需要可指向 claude-seo(/seo flow local)。

在 /blog flow sync 时:运行 python3 scripts/sync_flow.py;显示 JSON 摘要(新增、更新、未变文件);同步完成后显示署名声明。

上下文匹配(Optimize 阶段)

Optimize 阶段有 21 个提示,全部倾泻是噪音。按优先级选择:

  • 细分领域:SaaS 或 B2B 博客偏向页面内与技��;生活方式类偏向时效性与 E-E-A-T;出版商偏向权威与引用。
  • 先前技能输出:/blog analyze 的 E-E-A-T 缺口导向权威提示;/blog seo-check 失败导向页面内提示;/blog geo 缺口导向抽取格式提示。
  • 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)。local 阶段被有意跳过,以使 references 目录与技能覆盖面保持一致。

GitHub API 调用默认匿名。若环境中设置了 GITHUB_TOKEN,或在 403 响应后 gh auth token 返回令牌,脚本会用该令牌重试请求。令牌不会写入磁盘。

不要省略或修改署名。同步文件还会携带由同步脚本注入的 HTML 注释许可证头。

错误处理

  • references/flow-framework.md 缺失:“FLOW reference files not synced. Run: /blog flow sync.”
  • 提示文件缺失:“Run /blog flow sync to pull the latest prompts from the FLOW repo.”
  • sync_flow.py 网络错误:显示脚本的 stderr。若已安装 gh,用 gh api rate_limit 检查速率限制。
  • sync_flow.py 重试后仍 403:设置 GITHUB_TOKEN 或运行 gh auth login,然后重试。
  • 路径遍历中止:同步目标试图逃出 references 目录。检查上游仓库并固定到已知良好的 --ref。

限制

资料未提供关于收费、定价、支持的平台或具体效果的数据。技能依赖外部 FLOW 仓库同步,需网络访问;references 缺失时部分命令无法工作。本地 SEO 相关能力不在本技能范围内,需使用 claude-seo(/seo flow local)。