dsh-dev-plan-presets 0.0.0-stage → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,24 @@
1
+ # dsh-dev-plan-presets — bundle 根补丁
2
+ #
3
+ # 0.3.0 起本包是 Host 插件:dev-plan preset 由 index.js 在运行时通过
4
+ # ctx.agentPresets.register() 动态注册,以便按设置切换施工子代理 preset。
5
+ # 这里**只挂根插件一行**,不再静态声明 @deepseek-ai/dsh-agent-preset;
6
+ # 否则会与动态注册重名,导致 preset 注册失败。
7
+ #
8
+ # 想改配置优先用插件页的本插件设置(写入 configEditor),不要手改 profile 的
9
+ # cordis.patch.yml;手工写 config 也合法,但会被完整校验。
10
+ - insert:
11
+ - id: dev-plan-presets
12
+ name: dsh-dev-plan-presets
13
+ config:
14
+ developMode: standard
15
+ childProvider: dsh-opencode-go
16
+ childModel: deepseek-v4.1-flash
17
+ childReasoningEffort: ''
18
+ modelGuardMode: pin
19
+ killOnViolation: true
20
+ honorExplicit: false
21
+ audit: true
22
+ guardAllSubagents: false
23
+ mainToolMode: ask-edit
24
+ mainStepWarnThreshold: 6
package/detail.md ADDED
@@ -0,0 +1,200 @@
1
+ # dsh-dev-plan-presets 详情
2
+
3
+ ## 一、这是什么
4
+
5
+ 一个给昂贵主模型用的 DSH Agent preset 包。主窗只做规划、派工与复核,实际施工交给 `develop` 子代理;内置子代理模型守门,避免子代理误继承昂贵主模型。
6
+
7
+ 0.4.0 的结构与提速优化:
8
+
9
+ - 从「bundle 里静态写一份 `@deepseek-ai/dsh-agent-preset` 行」改为「Host 插件在运行时 `ctx.agentPresets.register()` 动态注册」,只注册单个 `dev-plan` 预设,不向 DSH 预设列表暴露多余子预设;
10
+ - 主窗 persona 压缩至 ≤ 6,000 字符(SSOT 零重复),并将紧凑版侦察/文书模板融入主预设且明确标注**仅给子代理用**;
11
+ - 新增 `develop` 委派工具,让主窗直接派工、收汇报、派独立复核、再返工给同一 `developer`;
12
+ - 新增插件设置页(`plugins.row.config`)与 Host 路由:支持 `stateVersion`/`stateTag` + ETag `304`、700ms/30s 自适应轮询、`modelCatalog` 空闲预热、可选 `mainToolMode`(`none`/`readonly`/`ask-edit`,永不挂 Shell)与主窗步数软提醒阈值 `mainStepWarnThreshold`;
13
+ - 吸收 `dsh-subagent-model-pin` 的子代理模型守门能力;
14
+ - preset 真源从 YAML 迁移到 `preset.js`,运行期不依赖 `js-yaml` 或 `@deepseek-ai/schemastery`。
15
+
16
+ 内部 preset id 仍是 `dev-plan`;插件管理器显示名是「开发规划与交付模式」(英文 Development planning & delivery Mode),preset 名称仍是「开发规划与交付」。
17
+
18
+ ## 二、四个委派工具
19
+
20
+ | 工具 | 用途 | preset |
21
+ |---|---|---|
22
+ | `recon` | 查证、遍历、搜索仓库事实 | `standard` |
23
+ | `review` | 独立复核、证伪关键事实 | `standard` |
24
+ | `scribe` | 定稿文档逐字落盘 | `standard` |
25
+ | `develop` | 实际施工、跑测试、修缺陷 | 任意可用预设(默认 `standard`) |
26
+
27
+ 四个实例都是:
28
+
29
+ - `provider: spawn`(只有进程内 spawn 支持 `agentPreset`);
30
+ - `maxDepth: 1`;
31
+ - `modelSelection: false`、`modelDiscovery: false`;
32
+ - 不设 `allowedAgentPresets`;
33
+ - `agentOptions` 来自同一设置真源(`childProvider` / `childModel` / 可选 `childReasoningEffort`)。
34
+
35
+ `recon` / `review` / `scribe` 始终绑定 `standard`,紧凑版约束模板直接融入主预设并明确标注**仅给子代理用**(避免在 DSH 预设列表显示多余子预设);只有 `develop` 随设置切换。所选预设由宿主 `agentPresets` 目录决定,设置页不维护第二份白名单,并禁用内部预设 id。
36
+
37
+ ## 三、主窗合同
38
+
39
+ 主窗 persona 的硬规则:
40
+
41
+ 1. 自身永不亲自写代码;
42
+ 2. 默认只规划与复核,只有用户明确说「开工 / 施工 / 修复」才可派 `develop`;授权后必须实际调用 `develop`,只写/展示任务书、说“准备派工”不算派工;
43
+ 3. 派工事实以工具调用为准:任务书是 `develop` 的 prompt 参数,不是聊天交付;只有工具接受后才可称“已派出 developer”,之后结束回合等自动通知;`develop` 不可用/调用失败/未发生必须报告“未派工”及原因,不得假装成功;返工必须实际调用 `send_message`;
44
+ 4. 首次开发固定 `name=developer`,后续追问/返工用 `send_message` 续派同一个 developer,不反复新建;
45
+ 5. 收到汇报后可派独立 `review`,问题直接返工给同一 developer,不依赖双窗按钮;
46
+ 6. 只有扩大范围、越权或不可逆风险才问用户;
47
+ 7. 用户已明确批准开工时,不重复请求同一个开工批准;
48
+ 8. 同一任务不得同时使用 `develop` 和 `rework_task` / `ask_worker`;
49
+ 9. 不能把子代理自述当作自己已经运行测试;
50
+ 10. 派 `develop` 必须在创建参数 `cwd` 中传真实施工目录;派工前检查当前会话可写范围,不在范围内或无法确认时停止派工,不得先建后 cd,也不假设父会话事后提权会扩大已有子代理权限。
51
+
52
+ `develop` 的任务书必须自足,完整模板以 [docs/flow-redesign.md](docs/flow-redesign.md) 为唯一合同:目标、非目标、验收标准、允许改动路径、接口/依赖、检查命令、风险/回退、完成定义、实际变更证据、汇报格式。完工汇报必须附可审查的真实 diff(新文件/非 Git 给修改前后内容或等价证据),不能只给文件清单;主窗只拿到摘要时不得声称审过实际 diff,应先 send_message 要同一 developer 补证据。汇报固定含改动、真实命令与输出、自验收、风险、假设与未验证项、阻塞项、实际变更证据。子代理不向人类提问;缺信息或冲突在汇报里单列并停止相关动作。
53
+
54
+ ## 四、设置
55
+
56
+ 设置入口:插件 → 已安装 → 开发规划与交付模式 → 包含组件 → 点插件行标题/右箭头(`plugins.row.config`,key=`dsh-dev-plan-presets#dev-plan-presets`;入口不一定显示 “Configure”)。
57
+
58
+ | 字段 | 默认 | 说明 |
59
+ |---|---|---|
60
+ | `developMode` | `standard` | 施工子代理 preset:任意已注册预设;损坏/自身项禁用 |
61
+ | `childProvider` | `dsh-opencode-go` | 四个工具共用;从宿主目录选择 |
62
+ | `childModel` | `deepseek-v4.1-flash` | 四个工具共用;随 provider 联动 |
63
+ | `childReasoningEffort` | 空 | 空 = 省略该键 |
64
+ | `modelGuardMode` | `pin` | off / audit / pin |
65
+ | `killOnViolation` | `true` | pin 下越界是否打断 |
66
+ | `honorExplicit` | `false` | 是否尊重子代理显式路由 |
67
+ | `audit` | `true` | 是否写审计日志 |
68
+ | `guardAllSubagents` | `false` | 默认只守 dev-plan 子代理;勾选后全局 |
69
+ | `mainToolMode` | `ask-edit` | 主窗工具权限:`ask-edit`(默认,`read`/`edit`/`write` 经同意局部微改,无 Shell)/ `readonly`(仅 `glob`/`grep`)/ `none`(纯规划派工) |
70
+ | `mainStepWarnThreshold` | `6` | `mainToolMode !== 'none'` 时主窗单轮步数软提醒阈值(`2..30`,永不改模型/不取消) |
71
+
72
+ 保存链路:Client → `/plugins/dev-plan-presets/config` → 严格 Standard Schema 校验 → `configEditor.edit(entry, ...)` → profile patch → Loader 重建。不手改 profile 的 `cordis.patch.yml`,也不在插件目录写 `config.json`。
73
+
74
+ 配置是普通非 volatile 字段:保存后插件重建,preset 重新动态注册;现有会话保留旧代际,新建会话使用新设置。`configEditor.edit` 会 await reconcile;保存返回时已尝试重建/应用新配置,前端以回读值为准。
75
+
76
+ 设置页行为:
77
+
78
+ - `/state` 404 时显示“重启 DSH 并确认插件行启用”的指引并停止自动轮询,手动刷新可重试;网络错误显示“确认 DSH 运行/插件启用,点刷新重试”,原始错误作 mono 次要文本;
79
+ - POST 仅接受 `application/json`(允许 charset),否则 415;cross-site 或 Origin 与请求 Host / `webServer.getOrigin()` 实际监听 origin 不一致返回 403(127.0.0.1 / localhost / [::1] 同端口有限等价),被拒绝请求不调用 configEditor;反代改写 Origin/Host 本轮不支持;
80
+ - 语言跟随宿主 `ctx.locale`,主题只用已核实的 `--dsw-alias-*` / `--dsw-radius-*` token;
81
+ - guard 由插件总 disposer 跟踪,插件卸载/HMR 会移除所有已装 `agent/pre-step` 守卫。
82
+
83
+ ## 五、施工方式与回退
84
+
85
+ 默认 `standard`:完全不需要深度 PTC,零额外依赖。
86
+
87
+ 设置页“施工方式”下拉读取宿主 `agentPresets` 目录:
88
+
89
+ 1. 列出真实预设的名称与 id;`standard` 始终可选。
90
+ 2. `dev-plan` 自身禁用,避免 develop 递归派工。
91
+ 3. 带 broken 诊断的预设显示但禁用,并说明加载失败。
92
+ 4. 已保存的预设后来被移除/损坏时保留配置原值,页面提示;运行期先回退 `standard`,不静默改写配置。
93
+
94
+ 可用性只认 registry 中已注册且无 broken 的目标预设;目录读取超时或不可用时显式回退 `standard`:
95
+ - Host warning;
96
+ - 动态 preset `description` 写「已回退 standard」与原因;
97
+ - 主窗 persona 写「当前施工子代理模式:已回退 standard」;
98
+ - 设置页黄色横幅显示原因。
99
+
100
+ 启动后延迟复检一次:目标预设完成注册后把 `develop` 提升回所选值;期间先走安全路径。回退状态对模型和用户都可见,不是静默降级。
101
+
102
+ ## 六、流程提效(P0)
103
+
104
+ 完整开发/验收合同见 [docs/flow-redesign.md](docs/flow-redesign.md)。P0 只改提示词与流程,不新增设置/工具/依赖:
105
+
106
+ - **风险分级**:按歧义、影响面、可逆性、可验证性选快速/标准/高风险路径;快速路径不取消用户开工批准、developer 自验和主窗审查。
107
+ - **一次性开工契约**:范围、非目标、允许路径、接口/依赖、验收条件、检查命令、风险/回退一次写清;普通实现不反复等待批准,只有范围扩大、风险变化或宿主权限要求才重新确认。
108
+ - **验收前置与成本排序**:最小切片 → 语法/静态契约 → 针对性测试 → 必要运行/GUI;静态检查不等于真实验证。
109
+ - **非阻塞协作**:主窗不轮询、不忙等、不重复施工、不重复读取 developer 正在修改的文件;developer 只在阻塞、范围冲突或关键契约决策时打断主窗。
110
+ - **证据化报告与严重度返工**:developer 汇报 verified/partial/failed/未验证;主窗审实际 diff 与关键证据,阻塞问题 send_message 给同一 developer,非阻塞建议不无限打磨。
111
+
112
+ `recon` 仅缺事实时调用,`review` 仅高风险/确有需要时调用,`scribe` 仅文档属于验收或用户需要时调用;主窗最终审查责任不外包。
113
+
114
+ ## 七、模型守门
115
+
116
+ - 默认只管理父会话 preset 为 `dev-plan` 的子代理;判断优先用 `agentPresets.presetForSession(session)`,回退 `session.header.agentPreset`,都拿不到时跳过,避免误伤其他插件。
117
+ - 只认真正的子代理 header:`origin: 'subagent'` 或数值 `delegationDepth > 0`;带 `parentSession` 但 depth 0 的 fork 主对话不守。
118
+ - 勾选“同时管理其他插件的子代理”(`guardAllSubagents=true`)后恢复旧的全局子代理守门;主会话始终不守门。
119
+ - `pin`:创建时先装 `agent/pre-step` 守卫,再尝试 `agent.model.select()` 到目标路由;越界在发请求前 `reject`、`cancel` 并通知父会话。select 不可用或抛错时,`kill=false` 仍保留守卫做后续记录,`kill=true` 才 cancel。
120
+ - `audit`:只记录,不 select、不打断。
121
+ - `off`:完全不注册守门监听。
122
+ - `honorExplicit`:显式非父级路由不钉、也不挂会打断它的守卫。
123
+ - `audit` 日志只含事件、agent id 与路由,不含凭据。
124
+
125
+ 与旧插件并存时,若两边都开全局守门,请保持目标路由一致,并在验证新插件后禁用旧插件,避免双重打断。
126
+
127
+ ## 八、与旧插件迁移
128
+
129
+ 1. 安装并启用本插件,保留 `dsh-subagent-model-pin`;
130
+ 2. 新建会话验证 recon / review / scribe / develop 与守门记录;
131
+ 3. 确认无误后先验证本插件,再禁用旧插件,重启或等 HMR;
132
+ 4. 旧插件的 `config.json` / `pin.jsonl` 不再被读取,可保留作历史。
133
+
134
+ ## 九、机制与取舍
135
+
136
+ | 需求 | 机制 |
137
+ |---|---|
138
+ | 动态切换施工 preset | `ctx.agentPresets.register(definition)` |
139
+ | 配置变更重建 | 普通 Config → Loader 重启插件;旧会话保留旧 revision |
140
+ | 不静态重复注册 | `cordis.patch.yml` 只挂根插件 |
141
+ | 设置页 | Client `plugins.row.config` + Host `/state` `/config` 路由 |
142
+ | 配置持久化 | `ctx.get('configEditor').edit(ctx.fiber.entry, ...)` |
143
+ | 严格校验 | 手写 Standard Schema(`Config['~standard']`) |
144
+ | 回退探测 | registry 中存在且无 broken 的目标 preset 才算可用;loader entry 不再作证据;一次延迟复检 |
145
+ | 模型目录 | Host `llm.listProviders()` + `listModels(provider.id)`;单 provider 失败局部降级 |
146
+ | 模型守门 | `agent/created` + `agent/pre-step`;默认只守 dev-plan 子代理,主会话永不守 |
147
+ | 清理 | `ctx.on` / `ctx.effect` / `child.effect` / `agent.ctx` |
148
+
149
+ 不做的:
150
+
151
+ - 不做工具掩码或硬安全隔离;
152
+ - 不修改 `standard` preset、不修改桥接插件、不修改旧模型钉插件;
153
+ - 不写旧的 `presets/dev-plan.patch.yml`;
154
+ - 不在运行期解析 YAML;
155
+ - 不依赖深度 PTC 才能使用默认路径。
156
+
157
+ ## 十、验证与未验证项
158
+
159
+ 已执行(2026-11-18):
160
+
161
+ - `node scripts/verify-presets.mjs`:静态 **472 / 0**、行为 **55 / 0**、负向变异 **58/58**、`node --check` 全 PASS;
162
+ - `node --test --experimental-test-isolation=none`:**56 个单元测试**;
163
+ - `node --check`:index.js / preset.js / settings.js / guard.js / client.js;
164
+ - `npm pack --dry-run`:17 个文件,dry-run 通过。
165
+
166
+ 真实 Host 证据:
167
+
168
+ - 同版本 install 首次 `already-installed`;按 `nextStep` 执行 `remove_bundle → install_bundle` 后 remove `applied`、install `stage=enable changed=true application=applied warnings=[]`;旧 `include:preset-dev-plan` 消失,`include:dev-plan-presets` active。
169
+ - `GET /plugins/dev-plan-presets/state` 从 404 变为 HTTP 200:`registration=active`、`preset.id=dev-plan`、`error=null`、`warnings=[]`;初始 standard,`deepPtc.available=true / presetPresent=true / checked=true`。
170
+ - 真实 `POST /config`:`{}` → 200 unchanged;cross-site Origin+Sec-Fetch-Site → 403 forbidden-origin;text/plain → 415 unsupported-media-type;随后 state 配置不变。
171
+ - 真实 POST `{"developMode":"deep-ptc"}` → 200 applying=true;state requested/effective=deep-ptc、fallback.active=false、description 显示 deep-ptc。当前本机配置保留 deep-ptc 供新会话验收。
172
+ - 来源校验真实 POST(均为 `{}` 无变化):Origin=`http://127.0.0.1:1162` + same-origin → 200 unchanged;请求 127.0.0.1、Host/Origin=localhost → 200 unchanged(真实 loopback alias);Host/Origin=evil.example + same-origin → 403 origin-not-authoritative(DNS rebinding 形状);Origin 端口 9999 而 Host 1162 → 403 origin-mismatch。
173
+ - 普通 guard 冒烟 session `3f5e944a-7e6e-4feb-aa51-c03b161a2878`:descriptor 初始 `kimi-coding/kimi-k3.1-pro`,后续 `model/selection` 与 `request/header.config` 为 `dsh-opencode-go/deepseek-v4.1-flash`,`turn/end` completed。这证明真实创建时 pin 与实际请求路由,但不是 dev-plan/develop 测试,也不是越界 cancel 测试。
174
+ - **真实 dev-plan 成功会话(快速路径)**:主会话 `a582aad3-bad8-4a89-b915-f9c35c9cb2ed` 选择 dev-plan,模型为 `kimi-coding/kimi-k3.1-pro`;真实 `tool/call develop`(`name=developer`)结果为 `started subagent developer`,子会话 `92bdd971-9fd3-4ec3-9e98-316ec3eb9fa1` 的 `agentPreset/selected=deep-ptc`,descriptor/request headers 为 `dsh-opencode-go/deepseek-v4.1-flash`,实际 `run_code` + PTC dispatch,三轮 completed。主窗仅 3 次工具调用(develop + send_message×2),两次都是同一 developer(目录修正 + phase-2);`result.txt` 为 phase-2,证据含改前/改后内容/字节/二次读取与 diff。由此可标真实通过:快速路径、实际派工、deep-ptc develop、同一 developer 续派、证据化汇报;不宣称标准/高风险路径或固定提效比例。
175
+ - **旧 guard 迁移/新 guard**:`set_plugin` 精确 `include:subagent-model-pin` 后 applied/warnings=[];旧行 `enabled=false/fiberPhase=null`,`include:dev-plan-presets` active;独立 guard-solo 子会话 `93055ad8-4946-423e-9f71-fddbe399d4f8` 初始 kimi,随后 selection/header 为 opencode-go/deepseek-v4.1-flash,turn completed。证明旧 guard 关闭后新 guard 单独 pin;仍不是越界 cancel 测试。
176
+ - 真实 dev-plan 失败样本(回归来源,不是通过证据):session `4ac35a5d-491b-4bcc-9120-a7f31b1726c7` 只有任务书文本与“已派出”声称,无 `develop` 工具调用、无子代理、无产物,`turn/end` completed。修复后必须用新会话验证实际 `develop` 调用,不能把该会话写成通过。
177
+
178
+ 自检覆盖:四个工具、standard 默认、任意有效预设只切 develop、自引用/损坏/缺失回退且保留配置原值、主窗无施工工具、固定 developer 续派、双通道互斥、模型守门 pin/audit/off/honorExplicit、默认 dev-plan 范围与 global 开关矩阵、预设目录超时、模型目录枚举与单 provider 失败、旧路由保留、guard 卸载、设置路由读写/来源校验、设置页 label/帮助文本/动态下拉契约、打包文件完整,以及 P0 五条(风险路由、一次性契约、验收排序、非阻塞协作、证据化返工)与施工 `cwd`/权限防护的文本/变异/单元测试。
179
+
180
+ **未验证**(不得写成已通过):
181
+
182
+ - 0.4.0 新增真机 Host 验收项:
183
+ - 通过 `plugin_manager` 重新安装/启用 0.4.0 后,新建 `dev-plan` 会话验证 `recon` 实际使用 `dev-plan-scout` 且主窗不再输出千字模板;
184
+ - 对比真实任务体感耗时(规划输出长度、首次 `recon` 到回复耗时、`develop` 派工前等待时间);
185
+ - 在设置页切换 `mainToolMode` 为 `readonly` / `ask-edit`,新建会话验证主窗只读定位与“经用户同意后局部微改”行为,且主会话模型不被守门篡改;
186
+ - 验证设置页打开时模型列表即时显示、DevTools Network 面板稳态下转为 30s 保活 + `304`(不再每 4 秒全量刷新 `/state`)。
187
+ - 插件页“已安装 → 开发规划与交付模式 → 包含组件 → 行标题/右箭头”入口、设置页真实渲染、明暗主题、语言切换、ARIA/焦点环;
188
+ - 设置页 404 降级/停止轮询/手动刷新/network 指引的真实浏览器表现;
189
+ - 真实浏览器交互(按钮/焦点/提示);无 Origin 非浏览器客户端、非监听 host、更多代理/地址形态(真实 HTTP 已覆盖 same-origin、localhost alias、DNS rebinding 形状、错误端口;fake req 全矩阵不等于真实浏览器);
190
+ - 标准/高风险真实任务;主窗未做独立全盘审计,实际提效比例未观察;
191
+ - 真实越界 cancel 与父会话通知;
192
+ - 缺少 provider/model 时的报错与恢复;
193
+ - 预设下拉与 provider→model 联动在真实浏览器中的渲染、键盘操作、长列表与局部失败提示;
194
+ - 新增 `guardAllSubagents` 在真实 Host 会话中的范围验证(默认 dev-plan / 勾选全局)。
195
+
196
+ Host/state 路由、快速路径真实 dev-plan 成功会话(实际 develop/deep-ptc/同一 developer/证据)与普通 guard 冒烟已通过;不等于标准/高风险、越界 cancel 或 GUI 全流程通过。
197
+
198
+ ## 十一、许可证
199
+
200
+ MIT。
@@ -0,0 +1,403 @@
1
+ # 开发规划与交付 · P0 开发与验收合同
2
+
3
+ - 版本:0.3.0(`dsh-dev-plan-presets`)
4
+ - 日期:2026-11-18
5
+ - 状态:P0 已实现;真实 Host 路由/安装、快速路径与 guard-solo 已验收;标准/高风险、越界 cancel、GUI 等待验收
6
+ - 上游调研:`咨询/2026-11-18-开发规划流程提效/报告.md`(工作区文件,不随本包发布)
7
+ - 范围:只落地报告 P0 的五项提示词/流程改造
8
+
9
+ 本文件是 P0 的实现与验收合同。它描述**必须发生什么、什么算通过、哪些不做**,不是调研报告的复述。实现主要在 `preset.js` 的 persona、任务书与汇报合同;P0 本身不新增运行时、设置项或代理类型。设置页的预设/模型联动与守门范围是后续另一项改动,不属于本合同。
10
+
11
+ ---
12
+
13
+ ## 一、背景与目标
14
+
15
+ 当前 `dev-plan` 的流程是:主窗规划 → 用户批准 → 派 `develop` → 等子代理 → 审查 → 返工。慢的主要原因不是“代码写得慢”,而是:
16
+
17
+ 1. 每个任务都走相近的完整流程,快速任务被侦察、独立复核、文档环节拖慢;
18
+ 2. 计划、批准、验收分多次确认,普通实现改动反复等待;
19
+ 3. 检查顺序倒置:先做昂贵运行验收,晚期才发现语法/契约错误;
20
+ 4. 主窗在等待期间空等、轮询,或重复读取/重复施工;
21
+ 5. 汇报只有“完成/未完成”,返工没有严重度,容易无限打磨或漏掉阻塞问题。
22
+
23
+ P0 的目标:**先消除无效串行、重复确认和晚期返工,不引入重型任务系统。** 通过提示词合同让主窗按风险选最短安全路径、一次批准整个范围、按成本排序验收、非阻塞协作、按严重度返工。
24
+
25
+ 成功信号(观察性,不冒充严格 A/B):
26
+
27
+ - 验收项没有减少;
28
+ - 快速路径不调用不必要的独立代理;
29
+ - 阻塞问题能通过同一 developer 收敛;
30
+ - 没有增加文件冲突或漏验;
31
+ - 主窗等待时间下降,且不出现“静态检查当真实运行”的误报。
32
+
33
+ 否决信号:总耗时或返工反而上升、上下文不足导致误改、快速路径漏掉必要验收。出现时退回上一级流程,而不是继续加代理。
34
+
35
+ ---
36
+
37
+ ## 二、P0 范围与非目标
38
+
39
+ ### P0 范围(本文件全部要实现)
40
+
41
+ | 编号 | 能力 | 验收口径 |
42
+ |---|---|---|
43
+ | P0-1 | 风险分级 | 快速/标准/高风险三条路径;以歧义、影响面、可逆性、可验证性判定 |
44
+ | P0-2 | 一次性开工契约 | 范围、非目标、允许路径、接口/依赖、验收条件、检查命令、风险/回退一次写清;批准后普通实现不反复确认 |
45
+ | P0-3 | 验收前置与成本排序 | 最小切片 → 语法/静态契约 → 针对性测试 → 必要运行/GUI;静态检查不等于真实验证 |
46
+ | P0-4 | 非阻塞协作 | 依赖自动完成通知;主窗不轮询、不忙等、不重复施工、不重复读 developer 正在改的文件 |
47
+ | P0-5 | 证据化报告与严重度返工 | 真实命令/结果、verified/partial/failed/未验证、风险/假设;主窗审实际 diff 与关键证据;阻塞问题续派同一 developer |
48
+
49
+ ### 明确不做(P1/P2 及范围外)
50
+
51
+ - 不做受控双 developer 并行(P1,未启用,不默认双 developer)。
52
+ - 不做持久化任务卡、里程碑状态、指标记录、可检索任务产物(P1)。
53
+ - 不做 DAG 调度、Team、重型运行时、遥测(P2)。
54
+ - 不引入 LangGraph、Spec Kit、自研调度器或任何新依赖。
55
+ - 不为提速自动降低模型或推理档位。
56
+ - P0 本身不新增插件设置项;P0 是提示词/流程改造。后续设置页新增的预设/模型选择与 `guardAllSubagents` 不属于 P0 范围。
57
+ - 不改变主窗工具面、不改变 `develop` 的 `spawn / maxDepth=1 / modelSelection=false / modelDiscovery=false` 合同。
58
+ - 不取消用户开工批准、developer 自验、主窗最终审查。
59
+ - 不把 `review` 变成每任务强制步骤;不把 `scribe` 变成每任务强制步骤。
60
+
61
+ ---
62
+
63
+ ## 三、现状 → 目标流程
64
+
65
+ ### 现状(0.3.0 之前的行为)
66
+
67
+ ```text
68
+ 任务进入
69
+ → 固定分档/可能派 recon
70
+ → 给计划
71
+ → 用户批准
72
+ → 派 develop
73
+ → 主窗等待(可能轮询)
74
+ → 子代理汇报“完成/未完成”
75
+ → 主窗审查
76
+ → 返工(可能反复全量返工或无限打磨)
77
+ ```
78
+
79
+ 问题:路径不随任务变化;批准与验收约定分散;缺少检查成本排序;等待期间行为没有约束;返工没有严重度。
80
+
81
+ ### 目标流程
82
+
83
+ ```text
84
+ 任务进入
85
+ → 按歧义/影响面/可逆性/可验证性选快速/标准/高风险
86
+ → 只在缺事实时 recon;只在关键歧义时问用户
87
+ → 一次性开工契约:范围 + 非目标 + 允许路径 + 接口/依赖 + 验收 + 检查命令 + 风险/回退
88
+ → 用户批准整个已批准范围(一次)
89
+ → develop 连续完成
90
+ ├─ 子代理:最小切片 → 语法/静态契约 → 针对性测试 → 必要运行/GUI
91
+ └─ 主窗:验收准备、基线审查、资料研究等非冲突工作(不轮询、不重复施工)
92
+ → developer 证据化报告(verified/partial/failed/未验证)
93
+ → 主窗审实际 diff 和关键证据(最终审查责任不外包)
94
+ ├─ 有阻塞问题:send_message 续派同一 developer,附现象/期望/路径/复验项
95
+ └─ 无阻塞问题:交付;非阻塞建议集中记录,不无限打磨
96
+ ```
97
+
98
+ `review` 是可选的独立复审,只用于高风险/确有独立复核价值;`scribe` 只在文档属于验收范围或用户需要时调用;`recon` 只在缺事实时调用。主窗始终负责最终审查。
99
+
100
+ ---
101
+
102
+ ## 四、风险路由矩阵
103
+
104
+ ### 判定维度
105
+
106
+ | 维度 | 低 | 中 | 高 |
107
+ |---|---|---|---|
108
+ | 歧义 | 目标、接口、验收都清楚 | 有少量可推断歧义 | 需求/接口/验收不清,猜测会改变产物 |
109
+ | 影响面 | 单文件/单模块/局部样式 | 多文件、单模块边界 | 公共机制、跨模块接口、权限、数据、发布 |
110
+ | 可逆性 | 易回滚,无副作用 | 可回滚但有迁移/兼容成本 | 删除、迁移、生产配置、强推 Git、密钥/权限 |
111
+ | 可验证性 | 有明确命令/人工步骤 | 需要组合检查 | 只能真实运行/GUI/外部环境证明,或证据不足 |
112
+
113
+ ### 路径矩阵
114
+
115
+ | 路径 | 适用 | 必做 | 可省略 | 不得省略 |
116
+ |---|---|---|---|---|
117
+ | 快速 | 范围清楚、单文件/小改、可回滚、验证明确 | 简短计划;一次开工确认;develop;developer 自验;主窗审查 | 不必要的 recon、独立 review、scribe、额外方案对比 | 用户开工批准、developer 自验、主窗最终审查 |
118
+ | 标准 | 多文件但需求明确 | 必要时 recon 补事实;一次契约;develop;主窗审查;必要时独立 review | 固定 waterfall、每任务 review、每任务文档 | 契约、验收、自验、主窗审查 |
119
+ | 高风险 | 公共机制、权限/数据/不可逆、需求模糊 | 澄清;契约;分阶段 develop;独立 review;真实运行/GUI 验收 | 不必要的形式化步骤 | 澄清、契约、独立复审、真实运行证据、主窗审查 |
120
+
121
+ 规则:
122
+
123
+ 1. 只选一条最短安全路径,不固定跑瀑布。
124
+ 2. 任务变复杂/风险升高时升级路径;任务变简单且证据充分时可降级。证据不足、只能真实运行/GUI 证明或当前无法验证时,只能升级路径并补证据,**绝不因验证困难降低路径等级**。
125
+ 3. 路径判断写进计划一句话;不把流程当 KPI,不为凑流程派代理。
126
+ 4. 用户说“直接给计划”时只降规划深度,不自动获得开工授权。
127
+
128
+ ---
129
+
130
+ ## 五、一次性开工契约与任务书模板
131
+
132
+ ### 开工契约(主窗写给用户/自己)
133
+
134
+ ```text
135
+ 范围:这次要做什么,边界到哪里
136
+ 非目标:明确不做什么
137
+ 允许路径:精确到目录/文件;不允许改动的路径
138
+ 接口/依赖:要遵守或改变的接口、数据形状、依赖与兼容约束
139
+ 验收条件:可逐条勾选的通过/失败判据
140
+ 检查命令:每条验收对应的最小检查命令或人工步骤
141
+ 风险/回退:主要回归风险、升级路径条件、回滚方式
142
+ ```
143
+
144
+ 规则:
145
+
146
+ - 用户批准一次,覆盖整个已批准范围。
147
+ - 普通文件编辑和实现细节由 developer 在契约边界内决定,不反复等待主窗/用户批准。
148
+ - 只有以下情况重新确认:范围扩大、风险变化、宿主权限要求(沙箱升权、安装/卸载、改 profile、破坏性操作)。
149
+ - 用户只说“给计划”时,契约只展示不派工;用户已明确批准开工时,不为同一范围重复请求批准。
150
+
151
+ ### develop 任务书模板(必须自足)
152
+
153
+ ```text
154
+ 目标:<用户原始请求的关键句 + 本次要达成什么>
155
+ 非目标:<明确不做什么>
156
+ 验收标准:
157
+ - [ ] <可勾选判据 1>
158
+ - [ ] <可勾选判据 2>
159
+ 允许改动路径:
160
+ - <文件/目录>
161
+ - 不允许改动:<路径>
162
+ 接口/依赖:<必须遵守的接口、数据形状、依赖与兼容约束;没有写“无新增接口/依赖”>
163
+ 检查命令:<对应验收标准的最小命令;无法运行写原因>
164
+ 风险/回退:<主要风险、停止并报告的触发条件、回滚方式>
165
+ 完成定义:<代码/测试/文档/不提交 Git 等>
166
+ 实际变更证据:<完工必须附真实 diff(git diff 或等价 unified diff);新文件/非 Git 给修改前后内容或可核对等价证据;不能只给文件清单>
167
+ 汇报格式:按「施工汇报格式」回传
168
+
169
+ 工作区:<绝对路径>
170
+ 当前状态/相关文件:<简要>
171
+ 项目规范入口:<AGENTS.md 等>
172
+ ```
173
+
174
+ 首次派工固定 `name=developer`;后续追问/返工用 `send_message` 给同一 developer,不新建、不换人。任务书不能要求 developer 再向人类提问;缺信息或冲突在汇报中单列并停止相关动作。
175
+
176
+ ---
177
+
178
+ ## 六、developer 执行与证据报告合同
179
+
180
+ ### 执行顺序(成本从低到高)
181
+
182
+ 1. **最小切片**:先完成一个能证明方向正确的最小可运行/可审查改动。
183
+ 2. **语法/静态契约**:语法检查、类型/配置/schema、静态合同自检。
184
+ 3. **针对性测试**:覆盖本次改动和关键回归点的最小测试集。
185
+ 4. **必要运行/GUI 验收**:只有静态与单测无法证明的行为,才执行真实会话、真实 Host 或 GUI 验收。
186
+
187
+ 不得跳级把“静态检查通过”写成“真实运行验收通过”;没有执行的检查标成未验证。
188
+
189
+ ### 派工事实
190
+
191
+ 主窗写或展示任务书**不是派工**;唯一派工事实是实际调用 `develop`(首次 `name=developer`)并收到工具接受结果。
192
+
193
+ - 顺序:形成自足任务书 → 实际调用 `develop`(任务书作为 prompt 参数)→ 工具接受后才可说“已派出 developer” → 结束当前回合等自动通知。
194
+ - 只有文本任务书、没有工具调用时,不得声称已派出/已返工/已验证。
195
+ - `develop` 不可用、调用失败或未发生:报告“未派工”及原因,不输出假装成功的流程汇总。
196
+ - 返工同样以实际调用 `send_message` 为准;只写返工文本不算已返工。
197
+
198
+ 这次真实 dev-plan 会话(`session-4ac35a5d-...`)就是该失败模式:主窗输出完整任务书并声称已派出,但日志无 `develop` 调用、无子代理、无产物,`turn/end` 却 completed。该会话只作为回归来源,**不是通过证据**。
199
+
200
+ ### 汇报格式(固定)
201
+
202
+ ```text
203
+ 1. 改动:文件与目的;没有改什么也写明
204
+ 2. 真实命令与输出:逐条命令、退出码、关键输出;每项标 verified / partial / failed / 未验证
205
+ 3. 自验收:对照验收标准逐条写 verified / partial / failed / 未验证
206
+ 4. 风险:回归风险、未覆盖场景、需要主窗复核的点
207
+ 5. 假设与未验证项:缺信息、冲突、无法验证的内容
208
+ 6. 阻塞/需主窗决策:没有写“无”;有则写现象、期望、相关路径与建议
209
+ 7. 实际变更证据:优先真实 diff(git diff 或等价 unified diff);新文件/非 Git 工作区给修改前后内容或可核对的等价证据;不能只给文件清单。证据过大给分段/关键片段+完整证据位置
210
+ ```
211
+
212
+ ### 打断主窗的边界
213
+
214
+ developer 只在以下情况打断主窗:
215
+
216
+ - 阻塞:缺关键输入、权限/环境不可用、无法继续;
217
+ - 范围冲突:任务书与仓库事实/项目规范/更高优先级指令冲突;
218
+ - 关键契约决策:接口、数据、依赖、验收标准需要主窗/用户拍板。
219
+
220
+ 普通实现细节、文件命名、测试命令、局部重构由 developer 自行决定并写进汇报,不频繁请求确认。
221
+
222
+ ---
223
+
224
+ ## 七、主窗非阻塞、审查与返工规则
225
+
226
+ ### 非阻塞协作
227
+
228
+ - 依赖子代理自动完成通知;等待期间结束当前回合,不 `sleep`、不循环 `wait_agent` / `list_agents`、不反复确认进度。
229
+ - 不重复施工、不替 developer 改代码。
230
+ - 不重复读取 developer 正在修改的同一批文件;需要基线时读快照/已批准计划,或等汇报后读最终 diff。
231
+ - 可以做的非冲突工作:验收准备、审查基线、资料研究、独立任务;不得修改 developer 的允许路径。
232
+ - 不要求频繁进度汇报;没有新证据不反复催问。
233
+
234
+ ### 审查
235
+
236
+ 1. 先核对已批准契约/计划/项目规范,建立验收基线。
237
+ 2. 审实际 diff、关键命令与证据,不重复整个施工过程。主窗没有 fs/search/Shell/Git 工具,实际变更证据必须由 developer 随汇报提供。
238
+ 3. 没有实际 diff 或等价证据时只算“摘要审查”:不得写“已核对 diff/变更”,应先 `send_message` 要同一 developer 补真实 diff、修改前后内容或其他可核对证据;补证据仍走同一 developer。
239
+ 4. 只有高风险或确有独立复核价值时才派 review 读取/证伪;review 只是可选独立复审,不替主窗做最终判断。
240
+ 5. 按严重度分:阻塞(错误、漏范围、不可回滚、验收失败)→ 重要(回归风险、关键未验证项)→ 建议(风格、可选优化)。
241
+ 6. 主窗最终审查责任不外包给 review 或 developer。
242
+ 7. 静态检查全绿不能代替关键运行/GUI 验收。
243
+
244
+ ### 返工
245
+
246
+ - 阻塞问题用 `send_message` 续派同一 developer,附:失败现象、期望结果、复现命令/路径、重新验收项。
247
+ - 非阻塞建议集中记录,交用户决定;不为一两条风格建议无限打磨,不反复全量重跑。
248
+ - 同一任务不得同时使用 `develop` 和 `rework_task` / `ask_worker`;返工只走一条通道。
249
+ - 没有正确性问题就零问题通过;只有项目规范明确要求或影响正确性才报风格。
250
+
251
+ ### 代理调用纪律
252
+
253
+ - `recon`:只在缺少事实且事实会改变计划/验收时调用。
254
+ - `review`:只在真正高风险、关键事实需证伪、或确有独立复核价值时调用。
255
+ - `scribe`:只在文档属于验收范围或用户明确需要时调用。
256
+ - 不为凑流程调用;调用成本高于收益时,主窗自己完成允许范围内的静态审查。
257
+
258
+ ---
259
+
260
+ ## 八、配置与工具影响
261
+
262
+ P0 **本身不新增任何插件设置项**:
263
+
264
+ - P0 不新增 `flowMode`、`riskLevel`、`parallelism`、`maxDevelopers` 等流程配置。
265
+ - P0 不改变 `settings.js` 的 Config 字段;不改变 `cordis.patch.yml` 的默认配置。
266
+ - P0 不新增运行时依赖、不新增工具、不新增代理类型、不开启 Team、不引入 DAG。
267
+ - 不改变四个委派工具的 `spawn / maxDepth=1 / modelSelection=false / modelDiscovery=false / agentOptions` 合同。
268
+ - 不改变模型守门 `pin / audit / off`、`killOnViolation`、`honorExplicit`、`audit` 的判定语义。
269
+ - 不默认双 developer;不自动降低模型/推理档位。
270
+
271
+ 后续版本在本合同之外新增了设置能力:`developMode` 接受任意宿主预设、provider/model 改为目录联动选择、新增 `guardAllSubagents`(默认 `false`,只守 `dev-plan` 父会话派出的子代理)。这些改动与本合同共存,但不算 P0 流程提效的实现;本文档不据此扩大 P0 的验收口径。
272
+
273
+ 实现落点:`preset.js` 的 persona 文本;`README.md` / `detail.md` 的用户说明;`docs/flow-redesign.md` 本合同;测试与自检中的 P0 断言与变异。
274
+
275
+ ---
276
+
277
+ ## 九、可测试的行为断言
278
+
279
+ 以下断言必须由 `node --test` 和/或 `verify-presets.mjs` 覆盖;文本标记断言必须有对应负向变异,防止以后退化。
280
+
281
+ ### P0-1 风险分级
282
+
283
+ - persona 同时包含“快速路径 / 标准路径 / 高风险路径”。
284
+ - persona 同时包含四个判定维度:歧义、影响面、可逆性、可验证性。
285
+ - persona 明确证据不足/只能真实运行证明时提高风险等级或补证据,**绝不因验证困难降低路径等级**。
286
+ - persona 明确“快速路径不取消用户开工批准、developer 自验和主窗审查”。
287
+ - persona 明确“只选一条最短安全路径,不固定跑瀑布”。
288
+
289
+ ### P0-2 一次性开工契约
290
+
291
+ - persona 含“一次性开工契约”。
292
+ - 任务书含:范围、非目标、允许路径、接口/依赖、验收条件、检查命令、风险/回退。
293
+ - persona 明确“普通文件编辑和实现细节不反复等待批准”。
294
+ - persona 明确只有“范围扩大、风险变化或宿主权限要求”才重新确认。
295
+
296
+ ### P0-派工事实(真实失败回归)
297
+
298
+ - persona 含“文本不是派工”“必须实际调用 develop”“只有工具接受后才可说‘已派出 developer’”“未派工”“任务书是 develop 的 prompt 参数”。
299
+ - persona 明确“不得停在计划、前言或任务书文本”“实际调用 send_message”才算返工。
300
+ - 反向断言:不允许“文本也能算派工”“没有调用也可以说已派出”“文本任务书即视为已派工”。
301
+ - 回归来源:2026-11-18 真实 dev-plan 会话只输出任务书文本、无 develop 调用/子代理/产物,`turn/end` completed;修复后必须用新会话验证实际工具调用,不能把该失败会话写成通过。
302
+
303
+ ### P0-3 验收前置与成本排序
304
+
305
+ - persona 含“最小切片”“语法/静态契约”“针对性测试”“必要运行/GUI 验收”,且顺序正确。
306
+ - persona 含“静态检查不等于真实验证”。
307
+ - 汇报要求每项检查标 verified / partial / failed / 未验证。
308
+
309
+ ### P0-4 非阻塞协作
310
+
311
+ - persona 含“非阻塞协作”。
312
+ - 明确“不轮询”“不忙等”“不重复施工”“不重复读取 developer 正在修改的文件”。
313
+ - 明确 developer 只在阻塞、范围冲突、关键契约决策时打断主窗。
314
+ - 明确主窗等待期间可做非冲突工作,且不修改 developer 的允许路径。
315
+
316
+ ### P0-5 证据化报告与严重度返工
317
+
318
+ - 汇报含改动、真实命令与输出、自验收、风险、假设与未验证项、阻塞项、实际变更证据。
319
+ - 实际变更证据优先真实 diff;新文件/非 Git 工作区提供修改前后内容或可核对等价证据;不能只给文件清单。
320
+ - persona 明确主窗审“实际 diff 和关键证据”;只有摘要/文件清单时不得声称审过实际 diff,应先 send_message 要同一 developer 补证据。
321
+ - persona 明确“阻塞问题”续派同一 developer;“非阻塞建议”不无限打磨。
322
+ - persona 明确“主窗最终审查责任不外包”。
323
+
324
+ ### 核心约束不回退
325
+
326
+ - 主窗自身永不亲自写代码;主窗仍不挂施工工具。
327
+ - 首次 `name=developer`;同一任务 `send_message` 续派;不反复新建。
328
+ - `develop` 不与 `rework_task` / `ask_worker` 混用。
329
+ - `recon` 仅缺事实;`review` 仅高风险/确有需要;`scribe` 仅文档属于验收或用户需要。
330
+ - 四个委派工具合同保持原样;模型守门 pin/audit/off 与 kill/honor/audit 语义保持原样,默认范围收窄到 dev-plan 子代理(全局开关 opt-in)。
331
+
332
+ ---
333
+
334
+ ## 十、真实验证矩阵
335
+
336
+ | 层级 | 验证方式 | 能证明什么 | 不能证明什么 |
337
+ |---|---|---|---|
338
+ | 静态合同 | `node scripts/verify-presets.mjs` 的声明/文档检查 | persona、任务书、汇报格式、文档包含 P0 条款 | 模型是否真的按条款执行 |
339
+ | 单元/行为 | `node --test --experimental-test-isolation=none` | 动态注册、回退、守门、配置路由等代码路径 | 真实 Host 的 preset 挂载、GUI 渲染 |
340
+ | 负向变异 | `verify-presets.mjs` 的 MUTATIONS | 关键 P0 文本被删除/改写时自检会失败 | 模型行为退化 |
341
+ | 真实任务观察 | 3 个真实任务(小改/多文件/高风险) | 路径选择、等待次数、返工轮数、漏验情况、实际 diff 证据是否足够 | 严格同题 A/B、固定百分比提速 |
342
+ | 真实 dev-plan 成功会话(快速路径,2026-11-18) | 主会话 `a582aad3...`:`develop(name=developer)` 真实调用;子会话 `92bdd971...` 为 deep-ptc,路由 opencode-go/deepseek-v4.1-flash;主窗仅 develop + send_message×2(同一 developer:目录修正 + phase-2);证据含改前/改后内容、字节、二次读取、diff | 快速路径、实际 develop、deep-ptc develop、同一 developer 续派、非阻塞(无轮询/无多余代理)、证据化汇报 | 标准/高风险路径、主窗独立全盘审计、固定提效比例 |
343
+ | 旧 guard 迁移 + 新 guard solo(2026-11-18) | 精确禁用 `include:subagent-model-pin` 后 applied;旧行 `enabled=false/fiberPhase=null`;guard-solo 子会话 `93055ad8...` 初始 kimi,随后路由 opencode-go/deepseek-v4.1-flash,turn completed | 旧 guard 关闭后新 guard 单独 pin 并用于真实请求 | 不是越界 cancel 测试 |
344
+ | 真实 dev-plan 失败样本(2026-11-18) | 日志只有任务书文本与“已派出”声称,无 `develop` 调用、无子代理、无产物,`turn/end` completed | 证明“文本=派工”歧义真实存在,作为派工事实回归测试来源 | **不是通过证据**;修复后必须用新会话验证真实 `develop` 调用 |
345
+ | GUI/Host 验收 | 插件页、设置页、新会话、真实 develop | 运行期行为与用户可见结果 | 未执行的项仍属未验证 |
346
+
347
+ ### 尚未执行的真实验收
348
+
349
+ - [x] 快速路径真实 dev-plan 会话:实际 `develop` 调用与子代理存在;已由 session `a582aad3...` 验证。
350
+ - [x] 快速路径下同一 developer 续派:两次 `send_message` 都 delivered to developer(目录修正 + phase-2)。
351
+ - [x] 快速路径下 `develop` 实际挂载 deep-ptc:子会话 `92bdd971...` 的 preset/selected=deep-ptc。
352
+ - [x] 快速路径下 developer 证据化汇报:含改前/改后内容、字节、二次读取、diff。
353
+ - [x] 快速路径非阻塞观察:主窗仅 3 次工具调用,无轮询/重复施工/多余代理(单一样本)。
354
+ - [ ] 标准路径多文件任务:一次性契约是否足够,是否出现范围漂移。
355
+ - [ ] 高风险任务:独立 review 与真实运行验收是否按合同执行。
356
+ - [ ] 主窗只拿到摘要时是否拒绝声称审过 diff,并续派同一 developer 补证据。
357
+ - [ ] 阻塞返工是否只派同一 developer 并收敛。
358
+ - [ ] 真实越界 cancel 与父会话通知(guard 冒烟不是 cancel 测试)。
359
+ - [ ] GUI 设置页、preset 选择器视觉/ARIA/语言/主题未验证。
360
+ - [ ] 主窗独立全盘审计、标准/高风险路径、固定提效比例未验证。
361
+
362
+ 已勾选项均有上面的真实日志/产物证据;未勾选项不得写成“已通过”,必须有新的真实任务记录或 GUI 证据。
363
+
364
+ ---
365
+
366
+ ## 十一、与调研报告 P0 的逐项追踪
367
+
368
+ | 报告 P0 | 本合同落点 | 实现位置 | 测试/验收 |
369
+ |---|---|---|---|
370
+ | 1. 风险分级与快速/标准/高风险路径 | 第四节;persona「分档与风险路由(P0)」 | `preset.js` | 静态标记 + 变异;真实任务观察 |
371
+ | 2. 一次性计划、批准和验收契约 | 第五节;persona「一次性开工契约(P0)」+ 任务书 | `preset.js` | 静态标记 + 变异;真实任务观察 |
372
+ | 3. 主窗非阻塞、禁止轮询和重复施工 | 第七节;persona「非阻塞协作(P0)」 | `preset.js` | 静态标记 + 变异;真实任务观察 |
373
+ | 4. 快速检查优先、真实验证状态分级 | 第六节;persona「验收前置与成本排序(P0)」+ 汇报格式 | `preset.js` | 静态标记 + 变异;真实任务观察 |
374
+ | 5. 严重度驱动返工,原 developer 续派 | 第七节;persona「证据化审查与严重度返工(P0)」 | `preset.js` | 静态标记 + 变异;真实任务观察 |
375
+
376
+ ### 与报告目标流程的差异(有意为之)
377
+
378
+ - 报告提到“文件所有权”,P0 用“允许路径/非目标”表达,不新增设置或任务卡。
379
+ - 报告 P1 的受控并行、持久化任务卡、指标记录不在本文件实现。
380
+ - 报告 P2 的 DAG/自动模型降级/重型遥测不在本文件实现。
381
+ - 本文件不承诺固定百分比提速;只定义可观察的流程与验收信号。
382
+
383
+ ---
384
+
385
+ ## 十二、验收清单
386
+
387
+ 实现完成后至少满足:
388
+
389
+ - [x] persona 包含 P0-1 ~ P0-5 的全部合同文本。
390
+ - [x] 任务书包含范围、非目标、允许路径、接口/依赖、验收条件、检查命令、风险/回退、完成定义、实际变更证据、汇报格式。
391
+ - [x] 汇报格式包含 verified / partial / failed / 未验证。
392
+ - [x] persona 明确“文本不是派工,只有实际工具调用并接受才是派工;未调用/失败报告未派工”。
393
+ - [x] 静态自检覆盖 P0 标记,并有负向变异。
394
+ - [x] node:test 覆盖 P0 文本合同、回退、守门、配置路由等行为。
395
+ - [x] README/detail 指向本合同。
396
+ - [x] 未新增设置项、依赖、工具、代理类型、Team/DAG。
397
+ - [x] 快速路径真实 dev-plan 会话:实际 `develop`、deep-ptc、同一 developer 续派、证据化汇报。
398
+ - [x] 旧 guard 关闭后新 guard 单独 pin 并用于真实请求(guard-solo,非越界 cancel)。
399
+ - [ ] 标准路径真实任务。
400
+ - [ ] 高风险真实任务与独立 review/真实运行验收。
401
+ - [ ] 真实越界 cancel 与父会话通知。
402
+ - [ ] GUI 设置页视觉/ARIA/语言/主题。
403
+ - [ ] 主窗独立全盘审计与固定提效比例。