京东黑客马拉松 · 产研 AI 原生赛区 · Vibe Coding 创意挑战

AI 会写代码,
我们让它完成交付

Flowness 是面向 AI 研发的交付生命周期运行时。把需求、构建、验证、发布、验收 固化为可安装、可恢复、可校验的流程协议,让不同 Agent 在统一状态、产物与门禁下协作。

Flow 不息参赛队伍
4 类 AgentClaude Code · Codex · Cursor · OpenCode
5 段生命周期define → build → verify → release → close

今天,团队每天都在发生这样一幕 ——

AI 说:“代码写完了。”

交付,却没有完成。

测试没跑、证据没留、审批被跳过、上下文丢了、回滚方案没人写—— 任务却已经停在了“看似完成”。

01 — 核心痛点

AI 擅长“写”,却没人管“交付是否成立”

不是模型不够强,而是从需求到验收的整条链路,缺少统一、可校验的约束。

01

产物散落,上下文易丢

AI 擅长生成代码,却缺少从需求到验收的完整交付约束。PRD、方案、测试、发布材料散落各处,任务经常停在“看似完成”。

交付不闭环
02

工具各异,规则难复用

Claude Code、Codex、Cursor、OpenCode 的入口与资产形态各不相同。团队切换工具时要重复配置,流程和项目规则难以沉淀复用。

多工具割裂
03

“已完成”没有门禁

Agent 的“已完成”缺少统一证据和机器门禁。测试、人工审批、发布与回滚检查可能被跳过;出问题后也难以追溯与恢复。

质量无背书
02 — 关键洞察

工程上的“跑通了”
不等于交付上的“验收了”

真正缺的不是更强的模型,而是一条可核验的“交付轨道”: 让每一次 AI 交付都有明确的输入、输出、证据和门禁,让“完成”从一句口头结论, 变成一个能被机器检查、能被人复核、能被回滚的工程状态

现在

“我觉得做完了”

口头结论 · 不可核验
Flowness

“门禁通过了”

工程状态 · 可核验 · 可回滚
03 — 解决方案

Flowness:一套可安装的交付生命周期运行时

产品由三层组成——安装即用,协议约束状态,产物沉淀证据。节点内部自由,节点边界严格受控。

Layer 1

安装与适配层

通过 npm CLI 一次初始化或更新目标项目,按 Agent 自动生成 commands、skills、rules 等原生入口。

flowness init4 类 adaptermanaged-update
Layer 2

协议与状态层

flowness.yaml 定义生命周期图、输入输出、证据与门禁;.flowness/progress.yaml 记录唯一运行状态。

lifecycle 协议状态机唯一状态权威
Layer 3

产物与门禁层

每次迭代在 flowness/iter-*/ 下沉淀 PRD、方案、变更、测试、风险、发布、回滚与验收材料。

结构化产物evidence 证据gate 门禁

默认生命周期

以状态机统一推进;只有产物、证据、Schema 与人工审批满足要求,才能进入下一节点,并支持中断恢复与失败重跑。

1
Define
需求定义
  • PRD
  • 原型
  • 人工审批
2
Build
构建实现
  • 变更报告
  • diff · recipe
  • code gate
3
Verify
验证
  • 验证报告
  • 测试结果
  • 风险复核
4
Release
发布
  • 发布计划
  • 回滚预案
  • 人工审批
5
Close
验收收口
  • 验收报告
  • 迭代总结
  • 人工审批
必要产物 证据 门禁 gate 当前节点
04 — 关键创新点

不替代编码 Agent,而是给它补上“交付轨道”

协议化生命周期

flowness.yaml 声明节点图、输入输出、证据和门禁,实现“节点内方法自由,节点边界严格受控”。

可验证运行时

状态机统一推进 define→build→verify→release→close;产物、证据、Schema、人工审批全通过才放行,支持中断恢复与失败重跑。

多 Agent 原生适配

一次初始化即为 Claude Code、Codex、Cursor、OpenCode 安装各自原生入口;外部 Skills、OpenSpec 只作节点内方法复用,不取代状态权威。

05 — 系统架构

谁写什么、谁负责状态、谁只是入口

Agent 是入口,CLI 负责安装管理,Flowkit 运行时是唯一的状态与门禁权威,Provider 只提供节点内方法。

Coding Agent 层用户入口
Claude Code/iter
CodexAGENTS.md
Cursorrules
OpenCode/iter
@jdt/flowness CLI安装与管理
init / update
status / doctor
providers
phase / check / next
Flowkit Runtime唯一状态权威
状态机 · 门禁 · Schema
lifecycle节点图 / 输入输出
stateprogress / 当前节点
gates输入 / 输出 / 证据 / 审批
schemasPRD / 报告 / 计划
Provider 层节点内方法(可选)
Agent Skills
Superpowers
Matt Pocock skills
OpenSpec
核心边界:Provider 提供方法但不写状态;只有 Flowkit runtime 能通过或阻断节点。工具可以换,交付标准始终一致。
06 — 产品 Demo

让每一次 AI 交付,都有流程、有证据、有结论

下面是 Flowness 控制台。以“会员权益改版 1.0”为例,看门禁如何拦住一次“看似完成”的交付。推荐用「演示导览」——一条剧本走完,边讲边演,评委一眼看懂每个功能在解决什么问题、带来什么价值。

flowness · 迭代工作台 / 会员权益改版 1.0
会员体系 / 会员权益改版 1.0
Verify 阻塞
!
无法进入 Release:缺少 test-results.md Verify 阶段要求登记测试结果后才能推进。补齐证据即可继续。
1Define✓ 已批准
2Build✓ recipe 通过
3Verify⚠ 阻塞中
4Release未开始
5Close未开始
Verify · Gate 检查
  • 前置输入齐全(PRD、原型)
  • 代码差异检查通过
  • 测试结果文件存在 缺少 test-results.md
  • 风险复核
  • 人工审批
本阶段产物
  • MDverification-report.md已生成
  • TRtest-results.md缺失
  • TSintegration.test.ts已生成
  • RMrisk-review.md草稿

产品把“完成”变成一件可以被检查的事:门禁没过,就进不了下一步—— 这正是 AI 交付最需要的那条底线。

07 — 价值贡献

把 AI 研发的“完成”,变成可核验的工程状态

对团队

统一多 Agent 的流程和资产,降低新项目接入、工具迁移与重复配置成本。

对交付

强制沉淀需求、变更、测试、风险、发布与验收证据,降低漏项、越级与返工风险。

对管理

形成可审计、可复盘、可度量的数据基础,让“完成”第一次变得可衡量。

4类 Agent 适配
完成生命周期内验收
门禁一次通过率
可采集验证
0手改状态
状态只由 runtime 写入
100%关键节点
留存证据可追溯

当前已完成四类 Agent 适配与真实业务分支全生命周期内部验收。试用阶段建议以接入耗时、 门禁一次通过率、返工次数、缺陷逃逸率和交付周期验证收益,不虚报尚未在线上采集的数据。

让现有 AI 能力,
真正进入稳定研发流程。

AI 会写代码,我们让它完成交付。

Flow 不息 · Flowness
队长 黄晓丹 司晓磊 高鹏飞 韩培东
京东集团 · 京东科技