qiaoqichaoandClaude Code
f38959b483
依据 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>
101 lines
6.2 KiB
Markdown
101 lines
6.2 KiB
Markdown
# 新版交付纠偏规格（四批）
|
||
|
||
版本：0.1 · 2026-09-30。依据：用户 2026-09-30 纠偏指令、
|
||
`test-evidence/20260930-v2-audit/audit.json`（审计轮次 `f118721`）、
|
||
[14 经验闭环](14-experience-loop.md)、[04 UI Spec](04-ui-spec.md)、
|
||
[原型的视觉与交互参考](prototypes/prescreen-workbench.html)。
|
||
|
||
本文件把纠偏要求落成规格与验收项，再据此实施。**旧的 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 开发交接](15-development-handoff.md) 冲突时，以本文件的交付定义与验收口径为准；
|
||
该文件的 T12/T13 顺延，先完成本文件的四批。
|
||
- Jev/Laya 可保持关闭、真实审批概率保持未校准、演示值明确标识——这些不阻碍本闭环交付。
|