Files
mini-openclaw-v2/docs/v2/16-delivery-corrections.md
T
qiaoqichaoandClaude Code f38959b483 docs(v2): 新增交付纠偏规格,T05–T11 改按部分完成记
依据 test-evidence/20260930-v2-audit 的审计结论:底层能力存在但产品闭环未接通。
16-delivery-corrections.md 定义交付口径、四项禁止的假接通方式、BR-45~51、
E-27/28、AC-46~57 四批验收;15-development-handoff.md §7 同步修正判定口径。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-30 12:32:30 +08:00

6.2 KiB
Raw Blame History

新版交付纠偏规格(四批)

版本:0.1 · 2026-09-30。依据:用户 2026-09-30 纠偏指令、 test-evidence/20260930-v2-audit/audit.json(审计轮次 f118721)、 14 经验闭环、04 UI Spec、 原型的视觉与交互参考。

本文件把纠偏要求落成规格与验收项,再据此实施。旧的 T05–T11 一律按"部分完成"记 (审计结论:有底层能力,但未接通产品闭环);不得因为旧任务标了完成就跳过缺失功能。

0. 交付定义

交付物是可用浏览器从头走完的产品闭环: 历史经验加工 → 装配预审 → 轨迹复盘与改进。三个模块各有清晰入口。

不允许用以下方式证明"接通"(审计已确认的偏差模式):

不允许 原因
只在测试或演示脚本里直接写 prescreen_run 正常发起评审不会产生记录,界面等于空的
只改 released 状态或返回一个版本号 知识版本实际未生效
固定返回值包装成"模型提炼成功" 提炼是假成功
手工改数据库、注入运行记录、用接口 mock 绕过执行链 绕过了真实执行链
只有卡片存储或孤立函数 卡片没被选入方案、没影响后续核查

单元测试仍可用 fixture;验收必须走真实执行链。

1. 新增业务规则(BR)

  • BR-45 正常预审执行链必须在运行结束时产出新版预审记录(运行视图、维度结果、轨迹), 由页面读取;不得依赖测试或演示脚本写入。owner:预审执行链。
  • BR-46 维度与阶段由本次实际执行的核查项与证据决定:方案未声明维度时不补占位轴; 阶段只表达证据成熟度,不看结论好坏(发现问题不降级、通过不升级)。
  • BR-47 模型不可用时必须显示未完成(降级记录 + 未完成项),不得用固定返回值冒充核查结果。
  • BR-48 历史经验加工必须走真实提炼入口:展示"大模型提炼"时须实际调用已配置模型; 模型不可用即明确未完成。历史来源与人工来源在视觉上必须可区分(文字+图标+样式)。
  • BR-49 新发布的卡片必须能被选入评审方案,并实际影响后续核查;否则不算完成。
  • BR-50 三个模块各有独立入口,按已确认原型的深色导航+浅色工作区实现; 不得只在旧页下叠加面板。复用旧能力不等于保持旧版布局。
  • BR-51 会议结果必须与对应材料版本和 AI 轨迹对照;改进候选发布必须调用真实知识发布入口, 发布后新运行使用新版本,旧运行仍可回放。

2. 新增错误码(E)

  • E-27 运行视图装配失败,运行级 RUN_STEP_FAILED:某步骤失败且非预算原因。 文案:本次核查有步骤未完成,已保留其余结果。
  • E-28 提炼不可用,运行级 EXTRACTION_UNAVAILABLE:未配置模型或调用失败。 文案:本次未能完成经验提炼,请稍后重试或改为人工创建。

(RUN_STEP_FAILED 只出现在运行结果的降级记录里,不构成 HTTP 错误;超时沿用 E-08。)

3. 新增验收项(AC)

第一批:接通正常预审执行链

  • AC-46 Given 演示项目与已确认材料,When 在页面发起预审并在队列中被执行, Then 产生新版预审记录(含维度结果与轨迹引用),面板可读到;刷新页面后仍可读取。
  • AC-47 Given 缺少必需数据的项目,When 执行,Then 缺证进入未完成项与降级记录, 不因缺证给出通过结论(沿用 BR-07)。
  • AC-48 Given 模型不可用,When 执行,Then 失败步骤保留、运行标记未完成、 面板显示未完成原因;不得伪造核查结果。
  • AC-49 Given 同一项目再次发起预审,When 执行完成,Then 生成新的预审记录, 旧记录仍可读取(沿用 BR-13)。

第二批:历史经验加工

  • AC-50 Given 模拟历史材料,When 选择案例并请求提炼,Then 若模型已配置则实际调用, 产出候选草稿;若模型不可用,返回 E-28 且不产生候选。
  • AC-51 Given 提炼候选与人工新增,When 用自然语言修改适用范围,Then 形成草稿修订, 不直接发布、不自批(沿用 BR-25/26)。
  • AC-52 Given 已发布卡片,When 装配评审方案,Then 卡片可被选入方案并影响后续核查 (在运行结果中可追溯引用了该卡片版本)。

第三批:按原型完成界面

  • AC-53 Given 已登录用户,When 打开工作台,Then 可见历史经验加工 / AI 预审 / 轨迹复盘 三个入口,采用深色导航+浅色工作区;不得只保留旧版落地页布局。
  • AC-54 Given 预审结果,When 查看,Then 概率状态与依据、动态维度、 推进沙盘、可回放轨迹均可操作,且与已确认原型一致(来源文字+图标,颜色不单独传意)。
  • AC-55 Given 新增路由与样式,Then 必须通过"防重复页面、权限、数据隔离"约束 (不再禁止新增路由或样式)。

第四批:评审反馈与改进发布

  • AC-56 Given 页面录入的模拟会议结果,When 保存,Then 与对应材料版本和 AI 轨迹对照, 未匹配的单列且不计入分母(沿用 AC-33/37)。
  • AC-57 Given 改进候选,When 完成对照验证与独立审核并发布,Then 实际知识版本生效: 新运行使用新版本,旧运行仍可回放;仅改状态或返回版本号不算通过。

4. 交付说明口径(每批必写)

每批交付必须列出:页面入口、操作步骤、实际结果、证据位置、剩余缺口。 未接通项标"部分完成",不得计入完成。

5. 本文件与旧文档的关系

  • 编号只追加:BR-45 起、E-27 起、AC-46 起;旧编号与旧状态记录保留。
  • 与 15 开发交接 冲突时,以本文件的交付定义与验收口径为准; 该文件的 T12/T13 顺延,先完成本文件的四批。
  • Jev/Laya 可保持关闭、真实审批概率保持未校准、演示值明确标识——这些不阻碍本闭环交付。