OpenFlow 深度解析：把 OpenSpec 和 Superpowers 串成流水线

原创

Adroation
Adroation

html5开发分享

2026年6月5日 10:39
北京

去阅读

我做了个工具，把 AI 编程的六个阶段串成一条流水线。

现在让我给你看看这条流水线是怎么跑起来的。

第一步：装， 5 分钟

npm install -g @lininn/openflow  npm install -g @fission-ai/openspec@latest /plugin install superpowers@claude-plugins-official

然后初始化：

openflow init --tools claude,codex,cursor,opencode

就这么简单。你会得到一组命令：

/openflow proposal   # 需求收敛 /openflow brainstorming  # 设计探索 /openflow spec       # 生成规范 /openflow build      # TDD 实现 /openflow amend      # 需求修订 /openflow close      # 验证归档

OpenFlow 到底在干嘛？

先说架构。

整个流程从用户需求开始：

核心思路很简单：OpenSpec 管需求规范化， Superpowers 管执行规范化， OpenFlow 管两个规范的翻译。

六个阶段深度解析

Phase 1: /openflow proposal

/openflow proposal

输入：一个自然语言需求描述，比如 \"我想给仓库加个 OAuth2 登录功能\"

输出：openspec/changes/add-oauth2/proposal.md

## Why 用户需要安全的第三方登录能力  ## What Changes - 新增 OAuth2 登录支持 - 修改认证中间件  ## Impact - 影响模块：auth, middleware

关键动作： OpenFlow 会问你 3-5 个问题来收敛需求：
 - 目标用户是谁？
 - 优先级是什么？
 - 必须满足的约束？
 - 有哪些非目标场景要排除？
 - 成功的判断标准是什么？

Phase 2: /openflow brainstorming

/openflow brainstorming

输入： proposal.md

输出：openspec/changes/add-oauth2/design.md

深度设计探索，多轮讨论后生成技术决策文档：

## 技术选型 - Provider: Auth0 (已生产验证) vs 自建：Auth0 - 存储：PostgreSQL 现有连接池  ## 关键决策 1. 使用 OAuth2 而非 OIDC：项目不需要用户管理 2. callback URL 硬编码：开发环境用 ngrok

Phase 3: /openflow spec

/openflow spec --id add-oauth2

输入： proposal.md + design.md

输出：
 - openspec/specs/auth/spec.md（结构化需求规范）
 - openspec/changes/add-oauth2/specs/auth/spec.md（需求 delta ）
 - plan-ready.md（工程执行计划）

这一步调用 OpenSpec CLI 生成规范，然后自动翻译成 Superpowers 能执行的格式。

Phase 4: /openflow build

/openflow build

输入： plan-ready.md

执行：
 1. reading-plans 拆出任务清单
 2. TDD 循环：
    - 先写测试
    - 再写实现
    - 验证通过
 3. checkpoint 断点续传
 4. 每个任务都记录到 tasks.md

Phase 5: /openflow amend（可选）

需求变更时的修订通道。不常用，但关键。

Phase 6: /openflow close

/openflow close --archive

验证一致性，归档完成的工作到 changes/archive/YYYY-MM-DD-[name]/。

真实场景演示

假设你要给现有项目加个功能：

场景：给仓库加 GitHub OAuth2 登录

1. 初始化

cd your-project openflow init --tools claude

2. 创建 proposal

/openflow proposal

回答 5 个问题后生成：

3. 深度探索

/openflow brainstorming

生成设计决策。

4. 生成规范

/openflow spec --id add-oauth2

生成 plan-ready.md，这是翻译层的关键输出。

5. 执行实现

/openflow build

然后就可以喝茶了。 Superpowers 会自己完成：
 - 列出任务
 - 逐个实现
 - TDD 验证
 - 断点续传

6. 验证归档

/openflow close

验证所有 test 通过，归档到 archive 目录。

为什么这很重要？

问题 1: 需求模糊

AI 编程最大的痛点不是\"AI 不够聪明\"，而是\"需求不够清晰\"。

OpenSpec 解决这个：
 - requirement 格式强制
 - scenario 必须写
 - delta 有结构

问题 2: 执行脱节

Superpowers 只管\"怎么执行\"，不管\"执行什么\"。

OpenFlow 解决这个：
 - proposal → spec → plan-ready 的翻译链
 - 一个文件，两个世界

问题 3: 流程断裂

手动流程： proposal → 读 spec → 手动拆任务 → TDD → 归档

OpenFlow 流程：/openflow proposal → /openflow build → /openflow close

三个一起装效果最好

npm install -g @lininn/openflow  npm install -g @fission-ai/openspec@latest  /plugin install superpowers@claude-plugins-official

一句话总结

OpenFlow 不是又一个 AI 编程工具，而是让已有的 AI 编程工具更好用的编排器。

它不生产代码，它只是代码的流程编排者。

GitHub: github.com/lininn/openflow[1]

你觉得 AI 编程最大的痛点是什么？评论区聊聊。

参考链接

[1] github.com/lininn/openflow: https://github.com/lininn/openflow