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>
This commit is contained in:
@@ -98,6 +98,13 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md,执行 git status --sh
|
||||
|
||||
## 7. 当前交接记录
|
||||
|
||||
> **交付判定修正(2026-09-30)**:T05–T11 一律按**部分完成**记。审计
|
||||
> (`test-evidence/20260930-v2-audit/audit.json`)确认:底层能力存在,但产品闭环未接通——
|
||||
> 正常发起评审不产生新版预审记录、历史经验加工不在实时 API 调用图上、
|
||||
> 轨迹/复盘/改进端点无前端消费、改进发布未接真实知识发布入口。
|
||||
> 交付定义与四批顺序以 [16 交付纠偏规格](16-delivery-corrections.md) 为准;
|
||||
> 下表的"已交付"只表示该任务包的代码与测试存在,不再表示产品功能可用。
|
||||
|
||||
- 日期:2026-09-30(T08–T11 实施轮;前一轮 T00–T07 见 git 历史)。
|
||||
- 仓库:`F:/mini-OpenClaw-v2`;远程 `http://192.168.10.111:3000/qiaoqichao/mini-openclaw-v2.git`
|
||||
(2026-09-30 新建并首次推送,OQ-06 Q2 的远程归属就此定案;端口/资源/CI 三问仍 open)。
|
||||
|
||||
@@ -0,0 +1,100 @@
|
||||
# 新版交付纠偏规格(四批)
|
||||
|
||||
版本: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 可保持关闭、真实审批概率保持未校准、演示值明确标识——这些不阻碍本闭环交付。
|
||||
Reference in New Issue
Block a user