依据 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>
6.2 KiB
6.2 KiB
新版交付纠偏规格(四批)
版本: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 可保持关闭、真实审批概率保持未校准、演示值明确标识——这些不阻碍本闭环交付。