OpenBitFun 智能体工作流场景收敛计划

September 4, 2026 · View on GitHub

范围:承接 product-requirements-agent-workflow-adjustment.md,把智能体工作流、审查、并发和成本控制压回真实用户场景。 本文不是新的 SDLC Harness 阶段路线图,不重新定义 P-1/P0/P1/P2/P3/P4。落地阶段仍以 implementation-plan.md 为准。

1. 收敛结论

OpenBitFun 不需要把 dynamic workflow 做成一个新的主产品模式。用户真正要的是:

  • 小任务快,并且知道哪些内容没有验证。
  • 重要改动能被合适强度地看一眼,而不是默认跑重审查。
  • 长任务不黑盒,token、耗时、阻塞和下一步清楚。
  • 批量任务可以并发,但 GUI 只呈现一个任务、一组状态和少量决策点。
  • 成本增加前必须说明为什么值得,且用户可以调整范围、暂停或只收敛已完成部分。

因此,workflow 只作为少数场景的后台执行策略。默认产品体验仍是“任务完成 -> 摘要 -> 已验证/未验证 -> 可选下一步”。

2. 不再推进的方向

不做原因
不建立第二套 P0-P4 workflow 路线SDLC Harness 已有实施路线,重复阶段会制造治理歧义
不在 P0/P1 定义新的核心 workflow 对象模型容易复制 Agent Kernel、DeepReview、Harness 和 QDP 的状态模型
不让用户选择或学习 workflow DSL用户关心任务结果,不关心编排语言
不默认启动多个 reviewer审查成本高,且小任务更需要速度和清晰未验证项
不默认显示任务控制台控制台只服务批量、长任务或用户需要决策的场景
不默认生成完整证据包、图谱或 PR 门禁这些只在 PR、团队、发布、事故、合规或大规模任务显露

3. 用户场景优先级

场景默认阶段映射用户目标默认体验
S1 低风险 bugfix / 文档 / 小 UI 调整SDLC P0快速完成,并知道未验证项单 agent,短摘要,不显示 workflow UI
S2a 本地显式审查SDLC P0/P1用户主动要求提交前快速看一眼可选 L1 快审;不自动进入 PR/团队流程
S2b PR / 受保护分支 / 团队规则审查SDLC P2发 PR 或进入受管路径前减少明显问题当前默认单 reviewer;目标行为只按具体问题有界复核;团队策略可提示严格审查,但仍需用户显式启动
S3 CI / 测试失败收敛SDLC P1/P2找到失败原因并修复先单 agent 诊断;多失败再聚类为队列
S4 PR review comments 批量修复SDLC P2快速处理可机械修复的意见按评论/文件分组,修复后快速复核
S5 大规模迁移 / 审计SDLC P3高完成率且风险可控先样本 gate,再预算确认,再批量执行

4. 场景设计

4.1 S1:低风险任务

要求
入口用户要求修一个小问题、改文档、小样式或低风险局部逻辑
默认执行单 agent,必要时运行最近的轻量验证
审查不默认创建 reviewer;任务结束仅总结实际运行过的验证,L0 仍属后续 Verify 探索
GUI保持聊天/任务结果视图,不显示成本面板或控制台
成本不展示 token 明细,除非预计异常超时或用户选择成本模式
完成标准给出改动、已验证、未验证、残余风险和下一步
禁止因为存在 workflow 能力而自动进入多 agent、证据包或图谱

4.2 S2:本地审查与 PR 审查分层

要求
本地显式入口用户在普通任务或提交前明确要求 review,可使用 L1 只读快审
PR/团队入口准备 PR、受保护分支、CODEOWNERS、团队策略或发布路径命中;归入既有 P2 PR/团队治理场景
默认执行先固定当前修改或明确 Git range 的 base/head、文件状态和完整度;一个只读主审先完成审查,仅为具体未解决问题发起有界补充检查;PR/团队路径按规则给 Review 面板和就绪度摘要
风险信号安全、性能、架构、跨模块、关键 UI 流程或验证缺口用于形成具体审核问题,不按标签、文件类型或能力数量机械增加 reviewer
严格审查条件当前由 /review strict、历史 /DeepReview alias 或内部显式 strict follow-up 启动;大型 PR、风险标签和团队策略本身不自动触发
GUI一个 Review 面板,按问题优先级合并输出
成本严格审查显示更完整覆盖、必要独立复核、通常更长耗时和只读边界;不把内部调用额度作为普通用户概念,不估算底层模型请求或 Token,也不声称提供尚未实现的范围调整
完成标准必须修复、建议确认、已覆盖、未覆盖、下一步清楚
禁止把 PR 审查压进 P0 默认体验,或把 DeepReview 作为普通 review 默认入口

当前基线:

  • 文件变更菜单和命令面板只提供 Review,不让用户先选“普通/严格”。
  • 当前 /review 启动一个只读主审,并可按具体问题调用零到两个补充检查;/review strict 可调用零到三个,条件质量检查占用同一额度,同时最多运行两个。/DeepReview 仅保留历史兼容。这不是静态风险升级规则;普通零补充检查路径不加载能力目录。远程工作区禁用自适应补充检查,但保留历史受管文件包的兼容执行。
  • 目标证据先于 Review 决策:当前工作区使用一次有界 HEAD -> worktree 取证,但没有 immutable snapshot,因此最终 evidence status 始终为 limited;显式 Git range 由目标准备层固定 base/head,完整且无遗漏、workspace binding 为 matching_clean 时 evidence status 才可为 complete。Reviewer 不自行猜 ref,缺失、截断或预算耗尽必须进入覆盖说明,但不改写模型 recommendation。
  • 只读 Reviewer 不获得通用 Git 或 shell 工具;Git 操作留在目标准备层。Reviewer 只通过有界 GetFileDiff 消费目标 diff;只有本地仓库与目标 head 匹配且整个工作区干净时,现有 Read/Grep/Glob/LS 才补充 live context。不做逐工具全仓重验、fetch、checkout 或仓库状态写入。
  • Strict Review 直接启动;运行状态和结果说明范围、实际覆盖、通常更长耗时和只读边界,不显示内部调用额度,也不估算底层模型请求或 token。
  • 修复不新开第二套产品界面:同一 Review 侧栏先把选中项交给 ReviewFixer;“审核修复”能精确归因时按原审核文件与 Fixer 直接改动文件的并集重新统计和决策,命令型修改无法可靠归因时明确提示并回退当前工作区 diff,在同一侧栏位置切换到新的隔离 Review 子会话。Fixer 基线和选中项在修复前持久化;follow-up 预留、relationship metadata 和后端 session id 复用同一 request id。启动确认不确定时保留稳定 turn 和已创建子会话、显示明确提示,不自动或在重启后重发启动消息;侧栏显示进行中和查看结果,只有明确失败的操作才提供重试。旧会话缺少范围信息时采用同样的显式工作区回退。
  • PR 面板是唯一内置 PR Review 入口:adapter 固定 provider identity、base/head 和按需远程 diff,启动同一套 Review,并按精确 PR revision 投影进行中、结果和过期状态。已移除 PR Review MiniApp 及其独立强度和 AI 草稿路径;平台 CI/审批/mergeability 事实仍与 AI Review 建议分层。当前不自动触发 Review,不生成或发布 inline comment,也不增加 approve、merge、checkout、缓存或 Finding 生命周期。

2026-07-10 合入后产品复盘:

  • 统一入口、普通 Review 单 reviewer、显式 Strict Review、只读 Reviewer、独立 ReviewFixer 和同侧栏 follow-up 已形成可用基线,不再新增 Review 执行分支。
  • 当前闭合 workspace / Git range / provider PR 三类目标证据,并保持一套 Review 执行链路。按问题协作不新增长期目标数据库、合成 diff 引用、跨 reviewer 内容缓存、Finding 生命周期、自动评论或结果动作。
  • 性能与质量先使用固定回放集和现有日志离线比较;没有稳定基准证明收益前,不新增 Review 专用遥测平台或默认执行分支。
  • PR 自动审查、跨 Review 增量对照、反馈学习、完整远程 checkout 和大规模任务控制台均不进入当前采纳范围;后续决策先看目标正确率、覆盖缺口和用户决策时间。

4.3 S3:CI / 测试失败收敛

要求
入口用户要求修 CI、测试失败、lint/typecheck 大量报错
默认执行先做失败诊断和最近失败聚类,不立即启动批量 worker
队列条件多个失败可独立处理,且有可运行 oracle
GUI长任务条优先;只有多个独立失败时显示任务控制台
成本多失败、多轮验证或多 reviewer 前提示预算
完成标准修复了哪些失败、仍失败哪些、不可运行原因和下一步
禁止无 oracle 时扩大并发;反复重试同类失败消耗 token

4.4 S4:PR review comments 批量修复

要求
入口用户要求处理 PR 评论或审查意见
默认执行按评论线程、文件和主题分组,先处理低冲突意见
队列条件评论数量多、机械修复明显、冲突范围可识别
GUI单一任务控制台,默认显示完成、阻塞、失败和需决策评论
审查修复后由同一 reviewer 做定向复核;高风险信号不自动扩展 reviewer
成本用户可选择只处理高价值评论或跳过低风险二次复核
完成标准已处理、需人工确认、未处理和建议回复内容明确
禁止为每条评论启动独立 chat 或独立 GUI 窗口

4.5 S5:大规模迁移 / 审计

要求
入口用户明确要求批量迁移、全仓审计或大规模一致性修改
前置有相似 work items、相对独立范围、可运行 oracle 或清晰人工验收标准
默认执行先 1-3 个样本,验证规则、冲突模型、oracle 和输出质量
扩大条件样本成功、预算确认、冲突策略明确
GUI一个任务控制台,突出进度、预算、阻塞、冲突和用户决策
审查分片审查只覆盖高风险路径、失败聚类和共享 contract
成本任务头常驻 token、耗时、并发、完成/阻塞/失败/跳过数量
完成标准可收敛已完成部分,阻塞项单独列出,不因少量失败丢失全部收益
禁止为追求完成率无上限追加 token;没有样本 gate 就全量并发

5. Review 强度规则

强度用户表达默认触发成本倾向
L0(后续探索)快速检查等待 Verify evidence 设计,不在当前生产策略中触发默认最低成本
L1独立审查普通 /review、提交前或 PR 前检查当前为一个只读 reviewer;目标行为仅按具体问题使用零到两个补充检查
L3严格审查/review strict/DeepReview 兼容输入或内部显式 strict follow-up更完整覆盖、必要独立复核、通常更长耗时和只读边界

原则:

  • 默认任务不启动 reviewer;显式 Review 固定为 L1。L2 只保留历史 manifest 兼容,不产生新启动;L3 只服务当前可识别的显式 strict 意图。团队策略只能提示,不自动启动,静态风险也不能直接增加补充检查。
  • reviewer 默认只读;修复必须进入用户批准的执行阶段。
  • 两轮审查没有新增有效问题时,应建议停止或保留核心检查。
  • 缺少上下文或 oracle 时,先提问或诊断,不启动 L3。

6. 成本和解决率平衡

决策点默认倾向
小任务优先首个有用结果时间,牺牲部分覆盖但明确未验证项
中风险任务优先一个 L1 主审和最近验证;只有具体未解决问题才使用有界补充检查
多失败任务优先失败聚类和可运行 oracle,再决定是否队列化
大规模任务优先样本成功率和可收敛性,再考虑并发
预算不足优先高风险/高价值 item,跳过低风险二次审查
解决率不足先问是否追加预算或调整目标范围,不静默扩大 token

用户侧必须能看到:

  • 为什么建议花更多 token。
  • 不追加预算会放弃哪些覆盖。
  • 追加预算预计提升的是解决率、覆盖率还是墙钟时间。
  • 目前可安全收敛的结果是什么。

7. GUI 交互约束

场景展示
普通任务任务结果摘要:改动、验证、未验证、下一步
长任务后台任务条:状态、阶段、预算、需决策
批量任务单一任务控制台:执行域、沙箱状态、阶段、数量、异常、预算、可下钻详情
审查Review 面板:问题优先、覆盖范围、未覆盖风险、操作
成本确认说明收益、成本、范围控制选项和停止选项

GUI 不展示多个 agent 窗口,不默认展示完整日志,不把内部术语作为主文案。

8. 指标保护 lens

本文不新增正式指标,只给采纳 workflow 能力时必须检查的保护视角。任何新指标都必须先进入 metrics spec;任何新采集都必须先进入 QDP 事件注册表。

观察项用途采纳边界
首个有用结果时间防止默认路径变重优先映射既有速度指标
用户打断率 / 弹窗触发率防止成本和审查提示打扰默认路径复用既有弱提示治理
成本预期偏差防止 token/耗时无感知上涨预算模式和采样口径明确后再采纳
任务解决率判断用户目标是否完成需要任务类型、完成判定和反馈来源
审查有效问题率判断 reviewer 是否值得默认启用只在 review feedback 事件稳定后采纳,不能作为 P0 默认门禁

P3/P4 再按需补充队列阻塞率、工作流回退率、后续返工率和维护 churn。不要让指标系统先于用户场景扩张。

9. 与既有文档的关系

文档本文如何依赖
product-requirements.md继承快速开发、上下文保障、团队治理、执行安全和合规/发布路径
implementation-plan.md复用既有阶段路线,不新增 workflow 专属 P0-P4
architecture/agent-workflow-design.md仅作为交互和边界补充,不定义独立核心架构
../architecture/deep-review.md普通与严格 Review 都复用既有目标证据、主审、ReviewWorker、历史队列兼容和 action surface;通用任务生命周期、scheduler 和队列状态归 Agent Kernel,Harness 只通过 provider/plan/step 参与编排
architecture/quality-data-plane.md复用既有最小事件和指标口径,不新增 P0 默认事件

10. 参考资料