概述

本项目的验收门控机制是一套多层次的质量保障程序，确保任务交付前满足预定义的验收标准。程序包含两大主要门控：

1. Acceptance Gate- 针对多步骤验收流程
2. Verification Gate- 针对代码变更后的单元测试验证

一、Acceptance Gate

主要架构

从文件位置来看。src/harness/task-acceptance-tracker.ts

说到主要类，TaskAcceptanceTracker

条件

// 从 goal 解析验收命令 const parsed = parseAcceptanceCommandsFromGoal;// 仅当 ≥ 条命令且为长跑 benchmark/goal 时激活 this.active = parsed.length>= && isLongRunningImplementationGoal;

命令解析规则

• 再看多步骤验收链，从 goal 文本中自动识别 npm ci → npm test → npm run build → npm run test:e2e 等链式命令。
• 从归一化匹配来看。
• npx vitest / npx vitest run --reporter=verbose → npm test
• npx playwright test / npx cypress run → npm run test:e2e
• 剥离 cd /d X &&,>&,管道重定向等噪声。
• 保留带命名空间的命令，如 npm run test:e2e。

状态流转

type AcceptanceCommandStatus = 'pending' | 'passed' | 'failed';interface AcceptanceCommandEntry { 从key来看，string;// 归一化键 说到label，string;// 原文展示 再看status，AcceptanceCommandStatus;lastRunAt，: number;}

状态更新流程：

1. 调用 recordRunCommand 或 recordRunCommandToolResult
2. 语义匹配第一条未通过/失败的验收项。
3. 返回 AcceptanceTransition.
4. 后台任务支持：
•     background_start / background_running → 保持 pending。
•     background_completed → passed。
•     background_failed / exitCode ≠ 0 → failed。
. } javascript `isComplete: boolean { if ) return true;说起来，return this.commands.every;}` 说到**关键特性，**
• TOD0：所有命令必须全部却认为任务已完成” 的痛点。
• TOD1：允许单条命令多次执行，方便重跑测试后快速看到最新结果。
• TOD2：支持 checkpoint 快照恢复 `TaskAcceptanceTracker.fromSnapshot`，避免因进程异常导致验证状态丢失而需重新跑完整链路。.
.

反馈注入机制

说到文件位置，src/harness/harness-tool-round.ts 再看函数。buildAcceptanceSuccessFeedbackMessage

反馈格式

less // 单条通过 npm test — files/tests passed // 全部通过 npm run test:e2e — e2e tests passed in .4s All acceptance commands passed. Output ≤ delivery bullets now and STOP calling tools. **规则**
• - 单条通过：仅显示✓ + 进度，不注入停止信号；此处解决“每个子任务都要手动确认”的繁琐痛点。
.
• - 全部通过：附加 “All N acceptance commands passed” + 停止指令；帮助 LLM 明确知道何时可以安全退出。.
• - 命令标签截断：≤ 字符 + ...；话说回来，避免长日志导致界面拥挤。
. ``

二、Verification Gate

主要架构

至于文件位置，src/harness/task-state.ts。src/harness/document-deliverable.ts

验证状态机

kotlin type VerificationStatus = 'not_required' | 'required' | 'passed' | 'failed';type TaskPhase = 'intent' | 'context' | 'editing' | 'verification';**状态流转示例** kotlin 无变更 → verificationStatus = 'not_required' 写工程源码 → verificationStatus = 'required',phase = 'editing' → 'verification' 跑单元测试成功 → verificationStatus = 'passed' 跑单元测试失败 → verificationStatus = 'failed' Acceptance 全通过 → markVerificationPassed → ‘passed’

交付物分类

kotlin type DeliverableKind = ‘engineering’ | ‘file_deliverable’ | ‘none’;// 工程源码 ENGINEERING_EXTENSIONS =;// 文件交付物 其余 名

写后读 Gate

scss // 写操作递增版本bumpFileDeliverableWriteVersion: void;tryConfirmFileDeliverable: void;// 未确认方法统计verificationConfirmationStats { required: number;pending : number;exempt : number;} **豁免方法规则**
1. .tmp/.bak 后缀、工作区相对 tmp//temp//cache/
2. 父目录以 . 开头
3. 临时脚本 check‑*.ps1,cleanup.ps1,verify‑*.sh
4. 项目自定义豁免方法 config.json/.icecoder.json 的 verificationExemptDirs

单元测试 Gate

文件位置这方面。src/harness/document-deliverable.ts,src/harness/verification-digest.ts

判定逻辑的观点是，

kotlin shouldPromptEngineeringUnitTest: boolean { if ) return false;return verificationStatus === ’required’;// 未跑过单测 } shouldInjectFailedUnitTestReminder: boolean { if ) return false;return verificationStatus === ’failed’;// 已跑但失败 }

工程源码方法识别：

lua engineeringTestTargetPaths: string { return filesChanged.filter( path => isEngineeringUnitTestTargetPath &&!isVerificationExemptPath);}

提示注入

成功提示（未跑单测)：

bash You changed source code but have not run unit tests yet. Run unit tests covered se changed files : - src/foo.ts - src/bar.ts Use run_command,n fix failures before claiming task is complete.

失败增加提示:

bash Unit tests failed for your recent changes. Please complete unit tests: fix failures。re-run tests via run_command,and only n finish. Changed source files: - src/foo.ts - src/bar.ts

Verification Gate计数器

文件位置这方面，src/harness/harness-verification-gate.ts

计数器重置规则：

kotlin shouldResetVerificationGateCounter( pendingBefore,pendingAfter,blockingAfter,acceptancePendingBefore,acceptancePendingAfter): boolean { if return true;// blocking解除 if return true;// file pending 净减少 if return true;// acceptance 净减少 return false;}

用途: 防止 LLM 在验证未完成时过早停止，计数器累积到阈值后强制 block。

三、门控集成流程

Harness工具轮循环

说到文件位置，src/harness/harness-tool-round.ts

Acceptance Gate集成点

php // run_command结果分类 const classified = classifyRunCommandResult;// 更新 Acceptance Tracker tracker.recordRunCommandToolResult;// 生成反馈消息 const feedback = buildAcceptanceSuccessFeedbackMessage({ newlyPassed :。completedAll : tracker.isComplete,passedCount : tracker.getPassedCount,totalCount : tracker.commands.length});老实说，if msgs.push;

Verification Gate 集成点

ini // 工具结果记录 taskState.recordToolResult;// 同步 Acceptance Gate 状态 syncTaskVerificationFromAcceptance;// 检查阻塞 const acceptanceIncomplete=tracker.hasPendingAcceptanceWork;const isBlocking=taskState.isVerificationBlockingFinal; // 生成prompt if{ const prompt=taskState.buildVerificationPrompt;msgs.push，}

完成判定

再看文件位置。src/harness/incomplete-completion.ts

hasPendingWork

代码片段这方面，

kotlin if)return true;if)return true;return false;不过，.

未完成时注入的观点是。

vbnet buildIncompleteContinuationPrompt:string{ const lines= The task is NOT complete. Do not stop without calling tools.','','Evidence:'];if){ lines.push);} if{ lines.push;} if){ lines.push;} return lines.join;} .

四、执行模式与门控协同

Execution Mode

说到文件位置，src/harness/supervisor/mode-decision-engine.ts.

模式信号

arduino type ModeSignal ='task_graph_active'|'pending_steps'|'multi_write' | ...;function shouldEnterForcedMode{ let reasons=;ifreasons.push;... }

门控协同

• free 模式 – LLM 自主决定工具调用。
• forced 模式 – 门控注入强提示，LLM 必须优先处理门控任务。
• ToolGate – DefaultToolGate.decide 在 forced 模式下可 block 特定工具。

五、测试覆盖

Acceptance Gate 测试

再看主要用例，

• 四命令验收链解析。
• 条件。
• 命令归一化匹配。
• 后台任务状态流转。
• 快照恢复 roundtrip。
• hasPendingWork 集成验证。

Verification Gate 测试

• 重置条件与保持逻辑。

执行模式测试

文件的观点是，test/harness/execution-mode-acceptance.test.ts

• free vs forced 切换。
• 信号优先级排序。

六、关键设计原则

分层门控

1. Acceptance Gate – 顶层多步骤验收。
2. Verification Gate – 对代码变更后的单测验证。其实，
3. File Deliverable Gate – 写后读确认非工程文件。

渐进式反馈

阶段	提示方式
单条通过	✓ + 简短进度
全部通过	停止信号 + “All …”
单测失败	增加提示但不硬 block

容错与恢复

• - 命令可重跑，多次覆盖同一条子任务；解决“误报失败导致停滞”。
.

Li>- 后台任务支持，即使是长时间 e‑e 测试也能继续监测并最终返回结果；避免 “因为超时而误判作业已完成”。

Li>- Checkpoint 快照恢复 TaskAcceptanceTracker.fromSnapshot；防止“进程崩溃导致全链路失效”。

. ​

七、配置参数

Execution Mode 参数

json { "executionMode":{ "pendingStepsEnterThreshold":10,"writeTargetsEnterThreshold":5,"diffLinesEnterThreshold":200,"stableRoundsExitThreshold":4,"modeLockRounds":12,"forcedMinDwellRounds":8。"readonlyToolNames": } } .

--- 验证豁免方法 ---

json { "verificationExemptDirs": } .

八、典型场景

Benchmark 四命令验收链

至于Goal，

`从零实现 survivors roguelike。只有 **npm ci ➜ npm test ➜ npm run build ➜ npm run test:e2e**
全部成功后才输出交付 bullet 并结束.`

再看流程，

1. - 自动解析出4条验收命令并激活 gate。
.

- 按顺序依次执行四个步骤，逐步获得✓反馈。
.

- 第四步通过后自动注入“All …”并停止信号，让 LLM 安全退出。
.

- hasPendingWork 返回false，允许最终结束。
.

---

工程源码变更场景

至于场景，修改 src/foo.js' 后未运行单测。

流程的观点是，

1. - write_file ⇒ verificationStatus='required'。.
• - 下一轮检测到阻塞，所以注入 提示使用者跑单测。.
• - 使用者执行 npm test'若成功则更新为'passed'`;若失败则触发增加提醒并要求 尝试。其实，.

---

后台长时间测试场景

场景的观点是。npm run test:e2e'` 用时分钟级别。不过，

1. - 调用 run_command 返回 'background_start'。，.
• - recordRunCommandToolResult 保持 'pending' 状态；持续轮询 action:'check' 得到 'background_running'。，.
• - 最终 action:'check' 返回 'background_completed';record -> 状态更新为 'passed'。，.

---

九、 点 & 自定义策略

新增验收命令类型

在 normalizeAcceptanceCommandKey 添加归一化规则。并在 isHarnessVerificationCommand 中匹配新类型，以便支持更多 CI/CD 网站。

自定义门控策略

实现自定义 Total ToolGate接口 decide 来控制特定工具在 forced 模式下是否被允许调用，从而满足不同项目对安全性的需求。

多语言支持

将所有反馈模板包装在国际化模块中，使得不同语言环境下均可获得一致且友好的提示信息。

---

-- 分析范围：验收门控机制