Merge authoritative main into the task branch
Why: include the current integration baseline before verification. Evidence: fetched origin/main=7e6c544b3c25c510e3d928bfb4515937a1cd6696. Impact: integrate upstream changes without rewriting task history. Refs: task-sync
This commit is contained in:
@@ -0,0 +1,413 @@
|
||||
# feature/conversation-handoff 任务卡
|
||||
|
||||
任务主记录:PR #651 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651;状态:已完成(合入前闭合);owner:weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= f97917032d143188bc7faf665aff612d9814af4e
|
||||
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff(worktree);分支:feature/conversation-handoff
|
||||
- 分支类型:standalone;root_target:main;immediate_target:main;accepting_requirements:false
|
||||
- 需求分流:verdict=NEW;selected_initiative=无;requirement_sha256=19ad0cf4b00048ede29774b079a28c2d8e417b9363c9cbe266ce99852b2594f9;triage_receipt=/tmp/task-handoff-triage-20261020.json;receipt_sha256=2ace0e14daaab36c1418ac3ce392cdbbf6e43722ddc86663b4939c8d85f9a930
|
||||
|
||||
- 授权与交付终点:更新本仓任务交付规范,规定每轮结束时最终回复附可续作 handoff;按现行门禁完成 Review、PR、CI、合入与安全收口。不得修改共享规范子模块或增加自动化。
|
||||
- 交付模式:goal-first(目标、范围和交付终点一次确认;范围内连续推进)
|
||||
- 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md)
|
||||
- 合入执行:agent(已授权交付范围内,Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入)
|
||||
- 人工决策点:仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段:最终验证与合入;当前增量:I1(对话收尾交接块规范)
|
||||
- 流程依据:仓库根目录 policy/delivery.md(归档后仍按仓库根目录定位)
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
在 `policy/delivery.md` 定义最终回复 handoff 的最小字段、证据边界和无续办状态时的处理,并在 `AGENTS.md` 增加强制入口。共享 Development-Guidelines、模板、schema、自动化和测试不是本次范围。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md;每次尝试一行,原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| conversation-handoff-rules | `AGENTS.md`, `policy/delivery.md` | 701aa8b8 | implementation | cursor, antigravity, pi | 1 | Cursor / auto | success | success (`a98f095`) | false | `/tmp/task-handoff-implementation-20261020.json` |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态:待核对(无适用规划时说明原因)
|
||||
- 主记录路径/版本:待核对(路径按仓库根目录定位,归档后不变;只引用唯一正文)
|
||||
- 对应里程碑:待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 每轮用户任务结束时提供可在上下文清理后恢复工作的 handoff | 与现有任务卡为状态权威、阶段 handoff 落盘规则一致;对话 handoff 仅作恢复摘要 | 必须 | 最终回复末尾有自包含续作要点,未发生的信息不编造;无仓库与续办状态时允许一行明确不适用 | 无 | 已实现;待 CI 准入 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用:待填写(含对象版本)
|
||||
- 实施计划引用:待填写(含增量与需求 ID)
|
||||
- 测试计划引用:待填写(含需求 ID 与验收条件)
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解/评估 | f97917032d143188bc7faf665aff612d9814af4e | 完成 | 主模型;NEW,与现有 RDM initiative 不相关 | 2026-10-20 | triage receipt `/tmp/task-handoff-triage-20261020.json` |
|
||||
| 方案/实施计划 | a98f095cef5ede016440d92060fa62db03b7318b | 完成 | 主模型;仅更新规范权威与入口摘要 | 2026-10-20 | 本卡目标与范围 |
|
||||
| 实施与自检 | a98f095cef5ede016440d92060fa62db03b7318b | 完成 | Cursor CLI;transport 成功,host 检查 | 2026-10-20 | `/tmp/task-handoff-implementation-20261020.json`;`git show --check --format= HEAD`;`make agent-exec-validate` |
|
||||
| 正式测试与验收 | 0dcaa430e0d724752aef1f55f120f419eeda9ad4 | 阻塞 | 文档直接检查通过;代码测试不适用 | 2026-10-20 | GATE CI run #4403 的 `test-pg` 失败,日志为 `TestArtifactFacadeCard` 的 anchorMessageId 不匹配;`svc-realcombo` 通过,`test` 当时 pending |
|
||||
| 代码 Review | 0dcaa430e0d724752aef1f55f120f419eeda9ad4 | 通过 | 主模型审阅规范差异及链接 | 2026-10-20 | 仅涉及 `AGENTS.md`、`policy/delivery.md`;无规范缺陷 |
|
||||
| 合入 | 待定 | 待执行 | agent | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | host | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | f97917032d143188bc7faf665aff612d9814af4e | f97917032d143188bc7faf665aff612d9814af4e | 2026-10-20T07:09:18Z |
|
||||
|
||||
## 证据(Evidence)
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入;手抄/转写输出视为无效证据(AGENTS.md 证据与验证门禁)。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态:持有最终窗口;调度记录:#518 comment 8266
|
||||
- entry_id:mq-dev-20261020-conversation-handoff-01;attempt_id:final-01;窗口执行者:host / weichen
|
||||
- 固定候选:无(base/head、组件与相关配置引用实际尝试)
|
||||
- 调度依据:policy/delivery.md#合入调度
|
||||
- 固定后证据:源码外 RECEIPT;实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果:增加最终回复 handoff 规范及 AGENTS 强制指针;与任务卡/持久阶段交接权威边界一致。
|
||||
- 验证:旧候选的 GATE 失败保留为历史;当前已同步权威 main 17f8bc06c110014b9101e7a33729d9f5445bd123,文档范围/字段/链接/现行规则保留、agent-exec validate 和递归组合检查均 SELF PASS(下方原始 evidence)。最终 HEAD 的 test/test-pg/svc-realcombo GATE 待运行。
|
||||
- 影响与剩余项:规范变更已就绪;Backend 修复 #226 已合入但 Dev 组合采用由独立 #653 承担。本 PR 仅规范与任务记录,须最终 HEAD 三项 CI 全绿后合入。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余:完成已授权的对话 handoff 规范;不属长期业务方案,剩余为当前候选 GATE、合入核验和安全收口。
|
||||
- 首选下一任务:完成本 PR 当前交付,无新增任务;新版运行时组合已有 PR #653,继续由原任务负责。
|
||||
- 推荐依据:待填写
|
||||
- 前置条件/待确认:待核对
|
||||
- 预期产物/验收条件:待定义
|
||||
- 重复任务核对:待核对(已有/在途任务、PR 与规划记录)
|
||||
- 启动授权:未授权(建议不自动启动新任务,仍须明确授权)
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录:PASS(主模型;head `0dcaa430e0d724752aef1f55f120f419eeda9ad4`;规范范围与链接审阅通过)
|
||||
- 冲突记录:NOT_RUN(最新目标同步、冲突处置、组合兼容核验及复审/补测)
|
||||
- CI 记录:FAIL(GATE;head `0dcaa430e0d724752aef1f55f120f419eeda9ad4`;run #4403;`test-pg` 的 `TestArtifactFacadeCard` 失败,`svc-realcombo` 通过,`test` 为 pending;[job 7138](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/actions/runs/4403/jobs/7138))
|
||||
- 合入记录:NOT_RUN(CI 未通过,未合入)
|
||||
- 清理记录:NOT_RUN(授权依据、写者退出确认、worktree/分支/任务卡处置)
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T07:08:07.377183+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"after_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=f97917032d",
|
||||
"[remote] origin/main=f97917032d ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks(pre-commit/post-merge 实际接线)",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] f97917032d(完整:f97917032d143188bc7faf665aff612d9814af4e)",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区:PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "601e28fd5627afdf978a470ef2b37265fee4ff28520a4668dd8e6a19ce5553e6",
|
||||
"receipt_sha256": "237e2888ced51370c2ca6ba41989e490f6e00c72bdbb74d008a15725efcaff65",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/237e2888ced51370c2ca6ba41989e490f6e00c72bdbb74d008a15725efcaff65.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录(合入前折叠)
|
||||
|
||||
- 本卡在 PR #651(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651)合入前闭合并归档,随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填,也无需单独的闭合 PR。
|
||||
|
||||
## 2026-10-20 恢复与 fail-stop 对账
|
||||
|
||||
- 用户再次明确“继续”,目标仍为 PR #651 通过必要验证并合入;已授权修复阻塞合入的 Backend 测试,禁止 host 代写。
|
||||
- 原 repair run `290c8b13f4a4a9e5d67df066754ab3fd` 的终态仍为 `scope-expansion`,没有 transport,不导入任何产物;原隔离现场保留。
|
||||
- 已只读检查唯一未跟踪诊断文件 `internal/server/zz_diag_tmp_test.go` 与实际工具事件;未发现仓库正式代码、引用或远端修改。机器本地诊断产物位于 `/tmp/ciflake-943183` 与 `~/.cache/ciflake-943183-tmp`,原执行器记录的进程及该现场写者已退出。
|
||||
- 原包把 `internal/server/**` 当作目录通配,但执行器仅按精确路径或目录前缀匹配;新单元须使用明确文件清单,不续跑原尝试、不修改执行器。
|
||||
- Backend 已登记任务工作区已保留并移至 `/home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests`,修复 Git 与唯一已初始化子模块的路径元数据;Dev 工作树的未跟踪嵌套工作区阻塞已消除。
|
||||
- 启动检查原始 SELF 收据:`/tmp/pr651-resume-20261020-a1.json`(SHARED_WORKSPACE_BUSY)、`/tmp/pr651-resume-20261020-a2.json`(任务卡已归档,拒绝 LOCAL_READY);不宣称通过。恢复活动卡后重新检查。
|
||||
- GATE 重新只读核验:PR #651 head `19566bfde79313dfaea31ff6f5ca918f820c1606` 仍开放;run 4404 的 test/svc-realcombo success,test-pg failure;日志 `/tmp/pr651-job7141.log`。目标 main 当前 `f1866dc3bb4537ac6446fdd26e696cb636b543ef`;#648 持有交付窗口,本任务先局部排障。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T08:46:38.272183+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "f9884db84b7fb5752d50b641f09adb75303e327c",
|
||||
"after_head": "f9884db84b7fb5752d50b641f09adb75303e327c",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"[repo] branch=feature/conversation-handoff head=f9884db84b",
|
||||
"[remote] origin/main=adbef2f49c ahead=6 behind=26",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks(pre-commit/post-merge 实际接线)",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[target] adbef2f49c6c252a09449496afbdb6685201993b(observed; task initial baseline is reported separately)",
|
||||
"[task-state] registered=/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff initial_base=f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"[verdict] LOCAL_READY — existing task may continue authorized local work; final delivery still requires latest-target sync and checks",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "be0eda106b0ed68d8f108a607b83c5231d1c34c744675a83995638fa5e39aa43",
|
||||
"receipt_sha256": "12bb48774c59da7635b3b0cf1ef81465b5fe29475baaf880c72a1a82a0649f46",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/12bb48774c59da7635b3b0cf1ef81465b5fe29475baaf880c72a1a82a0649f46.json"
|
||||
}
|
||||
```
|
||||
|
||||
- 局部恢复已通过并导入:`/tmp/pr651-resume-20261020-a6.json`(LOCAL_READY,SELF);正式交付需新鲜同步与固定 HEAD CI。
|
||||
- 新 repair 单元:`ci-pg-async-completion-r2`;固定 Backend base `e927694818f3c0b79ec663d70ab2aa9d47d8fd8f`;工作包 `/tmp/pr651-repair-unit-r2.json`;收据目标 `/tmp/pr651-repair-r2.json`;运行中,尚无成功产物。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:09:46.106201+00:00",
|
||||
"command": "cd /home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests && git rev-parse HEAD && GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./...",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"after_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"ok \tagent-system-backend/internal/runtime\t1.834s",
|
||||
"ok \tagent-system-backend/internal/server\t28.474s",
|
||||
"ok \tagent-system-backend/internal/settings\t0.211s",
|
||||
"ok \tagent-system-backend/internal/skills\t1.741s",
|
||||
"ok \tagent-system-backend/internal/squadadapter\t0.158s",
|
||||
"ok \tagent-system-backend/internal/store\t12.820s",
|
||||
"ok \tagent-system-backend/internal/surfacesvc\t0.399s",
|
||||
"ok \tagent-system-backend/internal/tools\t13.619s",
|
||||
"ok \tagent-system-backend/internal/vision\t0.003s",
|
||||
"ok \tagent-system-backend/internal/wfcompile\t0.050s",
|
||||
"ok \tagent-system-backend/internal/workflow\t0.002s",
|
||||
"ok \tagent-system-backend/pkg/extension\t0.004s",
|
||||
"ok \tagent-system-backend/pkg/extension/link\t0.006s",
|
||||
"ok \tagent-system-backend/pkg/identity\t0.095s",
|
||||
"? \tagent-system-backend/web\t[no test files]"
|
||||
],
|
||||
"output_sha256": "08769f0589e95d0b7878ce3551b931aceae5f80ad4916cc5f64bfd53ae5cfbb0",
|
||||
"receipt_sha256": "d0a0fa46d65618338b88d99c72e53402449454c740fe7399d6354b7a80f5d084",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/d0a0fa46d65618338b88d99c72e53402449454c740fe7399d6354b7a80f5d084.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:13:47.514647+00:00",
|
||||
"command": "cd /home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests && git rev-parse HEAD && git diff --check origin/main HEAD && GOWORK=off go test ./internal/server ./internal/runmgr -run \"^(TestArtifactFacadeCard|TestMockCardflowFullLoop|TestMockCardflowStreamLoop|TestBackground.*|TestProjectEvents.*|TestUnregisteredProjectEventsRetainLegacyReads)$\" -count=1",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"after_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"910d8e5fd20747eebc6e53b5fc0118185cb53765",
|
||||
"ok \tagent-system-backend/internal/server\t6.436s",
|
||||
"ok \tagent-system-backend/internal/runmgr\t0.495s"
|
||||
],
|
||||
"output_sha256": "3015a2c860e2066174d3f89da874b63b403192d9aa870b0a3fa4e238f1db9e24",
|
||||
"receipt_sha256": "5d2035b4cc2d543ec86a9fa19b93ed143ff6a637ab275a328827ad5ba02e7b56",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/5d2035b4cc2d543ec86a9fa19b93ed143ff6a637ab275a328827ad5ba02e7b56.json"
|
||||
}
|
||||
```
|
||||
|
||||
## Backend 修复结果与本 PR 最终范围
|
||||
|
||||
- repair r2 已通过 completed/transport:2ee469011e66b6bedcf6e9d87c8b1c026f7a8cef,仅三个测试文件;主模型审阅与独立重放通过。
|
||||
- Backend PR #226 已合入 508288fbed318ec808b1da1145417d062f9e0ce2;精确候选 910d8e5fd20747eebc6e53b5fc0118185cb53765 的 ci/vet-and-test、governance 全部 GATE success;来源 /tmp/pr651-backend-gate.json 与 /tmp/pr651-backend-merged.json。
|
||||
- 新版 Backend 同时包含尚待 Dev 组合采用的 O2 依赖,已有独立 PR #653;本规范 PR 不推进 gitlink,以免提前采用另一任务的运行时组合。#651 在最新 main 上重新验证,Backend 修复的已合入与 Dev 已采用分别记录。
|
||||
- 交付窗口 mq-dev-20261020-conversation-handoff-01 已在 #518 领取;此前 #652 已释放。当前需 task-sync、闭合任务卡、固定候选并等待三项 GATE。
|
||||
| 同步(记录前对象) | 17f8bc06c110014b9101e7a33729d9f5445bd123 | d0150787e2ba7fec94575e42c9bea2f945418c71 | 2026-10-20T09:20:53Z |
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:20:09.212113+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "0dd24cafc6024d5854957ff8f5b6ecb2c65d3c72",
|
||||
"after_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
" create mode 100644 .task/archive/feature-fast-slow-o2-i1-agent-native.md",
|
||||
" create mode 100644 .task/archive/feature-fast-slow-o2-i2-backend.md",
|
||||
" create mode 100644 docs/superpowers/specs/2026-10-20-fast-slow-o2-i1-review.md",
|
||||
" create mode 100644 docs/superpowers/specs/2026-10-20-fast-slow-o2-i2-review.md",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"admit: ok",
|
||||
"[evidence] WARN JSON receipt line 113: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 168: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 210: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 251: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=17f8bc06c110014b9101e7a33729d9f5445bd123 tested_head=11245d172c6841a17696a041889b8dbc4d8807a7 checked_at=2026-10-20T09:20:53Z changed=1 sync_target=main",
|
||||
"[next] 跑正式验收(make test 等),证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "447fa8d3b023bd473ca8076ad32b77ac406c86f6ff097e032b1c602e7a4649c6",
|
||||
"receipt_sha256": "faa7ddd69578d19c3c5280c5633868612431065be8ad6d74c37f15eca7642427",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/faa7ddd69578d19c3c5280c5633868612431065be8ad6d74c37f15eca7642427.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:21:27.020003+00:00",
|
||||
"command": "python3 /tmp/pr651-doc-check.py && make agent-exec-validate && make test-worktree",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"after_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "56ecb85dcdac1667ad1f575d1021a6f5306fabf593cfa8326465e9997f56c62e",
|
||||
"after_tracked_diff_sha256": "56ecb85dcdac1667ad1f575d1021a6f5306fabf593cfa8326465e9997f56c62e",
|
||||
"output_tail": [
|
||||
"tested Dev HEAD 11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"PASS handoff fields, authoritative links, document scope and preservation of current main policies",
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"python3 scripts/check-worktree.py verify",
|
||||
"[worktree] verify: recursive component checks passed",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "e7627921f53b21804805a831022ddae38dae1b31a328efabd2ad4db6a9329638",
|
||||
"receipt_sha256": "3f45ddbd4927efd7848281e5575c71ad8b5b411584650f5440cd9327e0c08ace",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/3f45ddbd4927efd7848281e5575c71ad8b5b411584650f5440cd9327e0c08ace.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 最终对象审阅
|
||||
|
||||
- host Review 对同步后 11245d172c6841a17696a041889b8dbc4d8807a7 完成:相对 origin/main 的业务差异只有 AGENTS.md 一行与 policy/delivery.md 新增 22 行,另有本任务记录;现行 AGENT-EXECUTION.md 与其它 policy 无回退。
|
||||
- 需求 R1 的七项 handoff 字段、无续办例外、证据权威边界和入口链接均直接复核通过。文档没有新增平台功能,不制造业务测试。真实模型行为前后量化 NOT_RUN;当前规范交付以可审条款、链接和 GATE 为依据,不声称完成行为评测。
|
||||
- main 同步原始输出、文档检查与递归组合输出均由 make evidence 原样写入本卡。最终候选固定后只保存在源码外记录,避免为回填 CI 再改变 HEAD。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:23:34.774230+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "2aad4bc2acf0cf7fb29ce5df604bcaff83c054bd",
|
||||
"after_head": "2aad4bc2acf0cf7fb29ce5df604bcaff83c054bd",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"[repo] branch=feature/conversation-handoff head=2aad4bc2ac",
|
||||
"[remote] origin/main=17f8bc06c1 ahead=11 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks(pre-commit/post-merge 实际接线)",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 17f8bc06c1(完整:17f8bc06c110014b9101e7a33729d9f5445bd123)",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区:PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "df04e4a972fd4f2eec24c391d8892c85698ca0f00fe9950df3d4b91c27df48a2",
|
||||
"receipt_sha256": "f676ac17f42a3634b98cc3287cb7f891df70b5361970c14c4bd3dcd77a6290fa",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/f676ac17f42a3634b98cc3287cb7f891df70b5361970c14c4bd3dcd77a6290fa.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录(合入前折叠)
|
||||
|
||||
- 本卡在 PR #651(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651)合入前闭合并归档,随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填,也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,164 @@
|
||||
# feature/fast-slow-o2-i2-backend 任务卡
|
||||
|
||||
任务主记录:PR #652 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652;状态:已完成(合入前闭合);owner:weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= d2035c76dc1cb15e01d2c184af5155d9d773cd9f
|
||||
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i2-backend(worktree);分支:feature/fast-slow-o2-i2-backend
|
||||
- 分支类型:standalone;root_target:main;immediate_target:main;accepting_requirements:false
|
||||
- 需求分流:verdict=NEW;selected_initiative=无;requirement_sha256=95d3a2ee34b8bdcabd1222b2ffbad0031a98717338fa400b8d7367d9d7d91610;triage_receipt=/tmp/o2i2-20261020/triage.json;receipt_sha256=88c443107094b249c62de6b88b0d3503d8caa4e420b802ebc4002dc58bb9250e
|
||||
|
||||
- 授权与交付终点:用户 2026-10-20 在 O2 I1 阶段 6 结论中选择“通过并启动 I2”(方案/计划阶段 4/5 已于同日通过)。终点:Backend I2 草稿 PR 经独立 Review 与 CI 通过 + 阶段 6 评审包,待用户阶段 6 人审后再合入。未授权:I3 Dev 改钉(I2 通过后启动)、P1 付费探针、写入任何实例的系统层配置、部署、真实模型/付费请求。
|
||||
- 交付模式:goal-first(目标、范围和交付终点一次确认;范围内连续推进)
|
||||
- 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md)
|
||||
- 合入执行:agent(已授权交付范围内,Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入)
|
||||
- 人工决策点:仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段:实施与自检;当前增量:I2(Backend 分支 feature/fast-slow-o2-i2-route-contract,base origin/main b5eb89c)
|
||||
- 流程依据:仓库根目录 policy/delivery.md(归档后仍按仓库根目录定位)
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标:Backend 以系统层三键 `models.routeContractEOF.model/.baseUrl/.identitySha256`(默认空 = 关闭)声明 O2 路由合同;5 个 `openLLMClient` 调用点统一按各自解析出的 (model, base) 精确判定是否挂 `RouteContractEOF`;`deps/agent-native` 改钉到 I1 合入提交 `2fc66be`。
|
||||
- 受影响:Backend `internal/runtime`(`openRouteClient`/`routeContractFor`)、`internal/settings/settings.go`、`deps/agent-native` gitlink。
|
||||
- 非目标:不改 Agent-Native;不写入任何实例配置;`runmgr` 无需改动(Backend 生产代码不记录终态字段,快慢通道收据由测试侧评估工具记录整个 `terminalObservation`,改钉后自动包含 `completionBasis`);Dev 改钉(I3)、付费探针(P1)不在本卡。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md;每次尝试一行,原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| o2-i2-backend-route-contract-config | deps/agent-native、internal/runtime/、internal/settings/ | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | — | invalid-config(host 把写单元包与派发并行执行,执行器读包时文件尚不存在;attempts 为空,无任何改动;fail-stop) | 未集成 | never | /tmp/o2i2-20261020/o2-i2-receipt.attempt1-invalid-config.json |
|
||||
| o2-i2-backend-route-contract-config | 同上 | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2(用户 2026-10-20 授权全新重跑) | cursor / auto | success | `e1a90a5`(ref refs/agent-exec/8eed31d0…/d97e9636,parent b5eb89c),`agent-exec apply` 快进集成 | never | /tmp/o2i2-20261020/o2-i2-receipt.json |
|
||||
| o2-i2b-eval-receipt-route-contract | internal/runtime/llm.go、internal/server/work_checkpoint_eval_test.go、internal/server/work_checkpoint_eval_route_contract_test.go | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | cursor / auto | failed-unknown(worker exit 1,原始日志末尾 `RetriableError: [internal] HTTP/2 keepalive ping timed out after 5000ms`;变更仅在允许路径内但未完成,执行器无法机械对账外部副作用;fail-stop,未换候选) | 未集成 | never | /tmp/o2i2-20261020/o2-i2b-receipt.attempt1-failed-unknown.json |
|
||||
| o2-i2b-eval-receipt-route-contract | 同上 | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2(用户 2026-10-20 07:54 对“授权全新重跑(推荐)”回复“继续”) | cursor / auto | success(219s) | `16f98b8`(ref refs/agent-exec/4792e791…/c578cdde,parent e1a90a5),`agent-exec apply` 快进集成 | never | /tmp/o2i2-20261020/o2-i2b-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态:待核对(无适用规划时说明原因)
|
||||
- 主记录路径/版本:待核对(路径按仓库根目录定位,归档后不变;只引用唯一正文)
|
||||
- 对应里程碑:待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | I2:Backend 系统层合同配置与按身份挂合同 | 符合:O2 阶段 4/5 通过;I1 阶段 6 通过(Agent-Native #48 合入 2fc66be) | P1 | 计划 §3 测试全部通过:缺省关闭;用户层写入被忽略;模型/基址/摘要任一不符不挂;视觉改模/轻量档独立判定;挂合同后假流放行一次工具并记 `route_contract_eof`;删除配置恢复拒绝;现有断言不删减 | I1 | 实施中 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用:docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md §4.5(Dev main,PR #639)
|
||||
- 实施计划引用:docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §3(I2)
|
||||
- 测试计划引用:同上 §3 测试与验证命令
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 待定 | 待执行 | — | — | — |
|
||||
| 实施计划 | 待定 | 待执行 | — | — | — |
|
||||
| 实施与自检 | Backend `16f98b8` | 完成 | Cursor worker ×2 单元 + host 验证 | 2026-10-20 | 收据表;host SELF 验证见评审包 §2 |
|
||||
| 正式测试与验收 | Backend `16f98b8` | 用户阶段 6 通过 | 用户 | 2026-10-20 08:06 | 用户对“通过:合入 #224 和 #652,并启动 I3(推荐)”回复“继续”;评审包 docs/superpowers/specs/2026-10-20-fast-slow-o2-i2-review.md |
|
||||
| 代码 Review | `e1a90a5` / `16f98b8` | PASS | 独立子智能体 8b8edce1(第 1 轮 PASS-with-fixes)、b0f773ba(第 2 轮 PASS) | 2026-10-20 | 见合入与清理节 Review 记录 |
|
||||
| 合入 | Backend #224 | 已合入 `c164950` | host(agent) | 2026-10-20 | 见合入记录 |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | 2026-10-20T06:05:02Z |
|
||||
|
||||
## 证据(Evidence)
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入;手抄/转写输出视为无效证据(AGENTS.md 证据与验证门禁)。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态:未入队;调度记录:无
|
||||
- entry_id:无;attempt_id:无;窗口执行者:无
|
||||
- 固定候选:无(base/head、组件与相关配置引用实际尝试)
|
||||
- 调度依据:policy/delivery.md#合入调度
|
||||
- 固定后证据:源码外 RECEIPT;实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果:
|
||||
- 验证:<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项;逐条证据由 make evidence 写入上方证据表>
|
||||
- 影响与剩余项:
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余:待核对(依据实际成果更新适用方案/规划)
|
||||
- 首选下一任务:待核对(无适用规划、已完成或受阻时如实说明,不虚构任务)
|
||||
- 推荐依据:待填写
|
||||
- 前置条件/待确认:待核对
|
||||
- 预期产物/验收条件:待定义
|
||||
- 重复任务核对:待核对(已有/在途任务、PR 与规划记录)
|
||||
- 启动授权:未授权(建议不自动启动新任务,仍须明确授权)
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录:第 1 轮——全新独立 Cursor 子智能体(agent 8b8edce1,fresh_session=true,只接收目标/计划/base b5eb89c..head e1a90a5 diff/CI),结论 PASS-with-fixes:5 条单元验收均满足(本地 SELF 重放 vet、`go test -race ./internal/runtime ./internal/settings`、gofmt、diff --check 通过)。阻塞(相对已批准计划 §3 I2“运行记录与快慢通道收据透传 completionBasis”,host 写单元包时漏列):`internal/server/work_checkpoint_eval_test.go` 的 `evalProviderStream` 直接构造 Client 不挂合同,`evalTerminalObservation`/`evalCallRecord` 白名单丢 `CompletionBasis`/`ContractCheck`。处置:属已批准 I2 范围,补派单元 `o2-i2b-eval-receipt-route-contract`。非阻塞(只记录):`internal/app/app.go:350` 小队内核直接构造 Client(不在批准的 5 个调用点内,维持失败关闭);`app.go:519` 意图生成器无合同无影响;5 个调用点与 `Execute` 的 nil-stream 分支靠审读确认;`settings.go` baseUrl 说明未提 fragment/userinfo。第 2 轮——全新独立 code-reviewer 子智能体(agent b0f773ba,fresh_session=true,只接收需求与 e1a90a5..16f98b8 diff),结论 **PASS,无阻塞项**:生产代码零行为变化(仅导出薄封装);评测判定经真实 settings 服务 `SetSystemOverride`+`Effective` 与生产同源;白名单无泄漏路径(含 PRIVATE_/C10/大小写反例);不匹配失败关闭;既有断言未删减。评审者重放(REPLAY):`go vet -tags live ./internal/server`、`go test -tags live ./internal/server -run 'TestEval|TestEvaluation|TestExtraA01|TestFollowupA01|TestMechanism'`、`go test ./internal/runtime` 均通过。非阻塞:配置了 `routeContractEOF` 却未挂上时评测静默按无合同运行(建议 P1 前改为 t.Fatal,避免浪费付费请求);合同对象未知键被静默丢弃。
|
||||
- 冲突记录:Backend #224 合入前 origin/main(b5eb89c)是 head 的祖先,无冲突;Dev 侧见同步记录。
|
||||
- CI 记录(Backend #224,GATE):head `16f98b8e4fbc413d65e2d76b761ffe19afc65a67` 全部 success——`ci / vet-and-test`(/weichen/Agent-System-Backend/actions/runs/4409/jobs/7158)、`governance / governance`(runs/4410/jobs/7159);前一 head `e1a90a5` 亦 success(runs/4382/jobs/7104、runs/4383/jobs/7105)。注意:CI 跑 `go vet ./... && go test ./...`,不含 `live` tag,评测文件 `internal/server/work_checkpoint_eval*_test.go` 的测试只有 host SELF(`go test -tags live ./internal/server` 24 项通过)与评审重放。
|
||||
- 合入记录:Backend PR #224(授权:用户 2026-10-20 08:06 阶段 6 通过)被核验 HEAD `16f98b8e4fbc413d65e2d76b761ffe19afc65a67`(CI success),合入 Agent-System-Backend main,merge commit `c16495006dbf1cf6ee581b48d99bba1e7f9a377c`,main tree `43129de` 与被核验 HEAD tree 一致。Dev 侧 gitlink 改钉由 I3 负责。
|
||||
- 清理记录:NOT_RUN(授权依据、写者退出确认、worktree/分支/任务卡处置)
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:04:02.239270+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"after_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=d2035c76dc",
|
||||
"[remote] origin/main=d2035c76dc ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks(pre-commit/post-merge 实际接线)",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] d2035c76dc(完整:d2035c76dc1cb15e01d2c184af5155d9d773cd9f)",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区:PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "32e2a7ee7d89e931af5b2d76a480bf3ccfb9367bff3bc01a91df24649e3a09d8",
|
||||
"receipt_sha256": "c2a4c48509432276fcb5c41d14a8e62e01dda2248d6e49da03b8438114e3650d",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c2a4c48509432276fcb5c41d14a8e62e01dda2248d6e49da03b8438114e3650d.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录(合入前折叠)
|
||||
|
||||
- 本卡在 PR #652(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652)合入前闭合并归档,随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填,也无需单独的闭合 PR。
|
||||
| 同步(记录前对象) | adbef2f49c6c252a09449496afbdb6685201993b | c70ebf53bfac50b460707d7eb6f482f20e697701 | 2026-10-20T08:08:33Z |
|
||||
@@ -0,0 +1,165 @@
|
||||
# feature/fast-slow-o2-i3-repin 任务卡
|
||||
|
||||
任务主记录:PR #653 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/653;状态:已完成(合入前闭合);owner:weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= adbef2f49c6c252a09449496afbdb6685201993b
|
||||
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i3-repin(worktree);分支:feature/fast-slow-o2-i3-repin
|
||||
- 分支类型:standalone;root_target:main;immediate_target:main;accepting_requirements:false
|
||||
- 需求分流:verdict=NEW;selected_initiative=无;requirement_sha256=8dcd51b91a010e321fa05269fd41d0d283d5d1f381da03127748631799667b15;triage_receipt=/tmp/o2i3-20261020/triage.json;receipt_sha256=29e82b237f2fe8ca0bb9dbae8edcdc62403b2f51ca72c718b81d70719aad7c2e
|
||||
|
||||
- 授权与交付终点:用户 2026-10-20 08:06 在 O2 I2 阶段 6 中对“通过:合入 #224 和 #652,并启动 I3(推荐)”回复“继续”。终点:Dev 改钉 `deps/agent-native`、`modules/backend`(及 `check-pins` 强制要求的连锁 `deps/agent-squad`),`make test`+`make build` 由 PR CI(GATE)确认后经 #518 窗口合入 main。未授权:P1 付费探针、写入任何实例的系统层配置、部署、真实模型/付费请求。
|
||||
- 交付模式:goal-first(目标、范围和交付终点一次确认;范围内连续推进)
|
||||
- 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md)
|
||||
- 合入执行:agent(已授权交付范围内,Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入)
|
||||
- 人工决策点:仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段:实施;当前增量:I3(计划 §4)
|
||||
- 流程依据:仓库根目录 policy/delivery.md(归档后仍按仓库根目录定位)
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标:Dev main 组合包含 Agent-Native `2fc66be`(O2 I1)与 Backend I2 合入点,`make test` 通过;默认关闭,行为不变。
|
||||
- 连锁改钉(`scripts/check-pins.sh` 强制各容器嵌套钉与 Dev 一致;先例 `234aa28`/`579a6fe`):Agent-Squad 嵌套 `deps/agent-native` 28f3ea7→2fc66be(Agent-Squad #55)→ Backend `deps/agent-squad` 改到 Agent-Squad 合入点(Backend 新 PR)→ Dev 一次改钉 `deps/agent-native`、`deps/agent-squad`、`modules/backend`。全部仅 gitlink,无产品代码改动。
|
||||
- 非目标:P1 付费探针、系统层配置写入、部署;O2 已记录的非阻塞项。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md;每次尝试一行,原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| o2-i3a-agent-squad-native-pin(Agent-Squad 仓) | deps/agent-native | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success(34s) | `ad58d0a`(ref refs/agent-exec/1695a49c…/559ef8a7,parent c0ce10a),`agent-exec apply` 快进集成 | never | /tmp/o2i3-20261020/o2-i3a-receipt.json |
|
||||
| o2-i3b-backend-squad-pin(Backend 仓) | deps/agent-squad | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `74f655c`(ref refs/agent-exec/70cdf684…/fcc4d2e0,parent c164950),`agent-exec apply` 快进集成 | never | /tmp/o2i3-20261020/o2-i3b-receipt.json |
|
||||
| o2-i3c-dev-repin(Dev) | deps/agent-native、deps/agent-squad、modules/backend | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success(46s) | `76c1c33`(ref refs/agent-exec/cba05e49…/b41a05cf,parent 409f476),`agent-exec apply` 快进集成;host `bash scripts/check-pins.sh` → pins ok | never | /tmp/o2i3-20261020/o2-i3c-receipt.json |
|
||||
| o2-i3d-backend-search-deadlock-test-pg(Backend 仓,扩围授权) | internal/store/search_deadlock_run_timing_test.go | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `9b23713`(ref refs/agent-exec/245f757e…/1faa105e,parent bb9274d),`agent-exec apply` 快进集成;host SQLite 下 `go test ./internal/store -run TestSearchDeadlockRegression` 通过 | never | /tmp/o2i3-20261020/o2-i3d-receipt.json |
|
||||
| o2-i3e-dev-backend-repin(Dev) | modules/backend | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `0ab8f8c`(ref refs/agent-exec/304f0c46…/bb83de1c,parent e799650),`agent-exec apply` 快进集成;check-pins ok | never | /tmp/o2i3-20261020/o2-i3e-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态:待核对(无适用规划时说明原因)
|
||||
- 主记录路径/版本:待核对(路径按仓库根目录定位,归档后不变;只引用唯一正文)
|
||||
- 对应里程碑:待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | I3:Dev 改钉 O2 组合 | 符合:O2 计划 §4;I1、I2 阶段 6 均通过 | P1 | Dev PR HEAD 上 CI `test`/`test-pg`/`svc-realcombo` 全部 success(含 check-pins);diff 只含 gitlink | I1、I2 合入 | 实施中 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用:docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md
|
||||
- 实施计划引用:docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §4(I3)
|
||||
- 测试计划引用:同上 §4:`make test` + `make build` 由 PR CI 确认
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 待定 | 待执行 | — | — | — |
|
||||
| 实施计划 | 待定 | 待执行 | — | — | — |
|
||||
| 实施与自检 | 待定 | 待执行 | — | — | — |
|
||||
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
|
||||
| 代码 Review | 待定 | 待执行 | — | — | — |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 扩围:Backend #223 测试方言缺陷 | Dev #653 @a64a68b CI `test-pg`(runs/4432/jobs/7197)确定性失败:Backend #223(其他会话,已在 Backend main)新增的 `TestSearchDeadlockRegression` 在 PostgreSQL 上调用仅限 SQLite 的 `searchKnowledgeFTSCandidates`(`syntax error at or near "MATCH"`);Backend CI 不跑 PG 未拦截;O2 I2 合在其上,改钉无法绕开。同 run `test` 失败为 npm ECONNRESET(runner 网络) | Backend `internal/store/search_deadlock_run_timing_test.go` 单文件,仅测试;生产代码不动 | 非 SQLite 方言跳过仅限 SQLite 的步骤后,Dev 组合 `test-pg` 通过即停 | 用户 2026-10-20 授权最小扩围(AskQuestion i3pg=fix_min) | Backend #227 合入 `d8923f1`(期间 main 被其他会话 #226 推进,已合并 main 后在 `803d64e` 重跑 CI 通过);Dev 改钉 modules/backend → d8923f1 | Dev 需再改钉 modules/backend 到修复合入点 | Dev 组合 CI 重跑 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | adbef2f49c6c252a09449496afbdb6685201993b | adbef2f49c6c252a09449496afbdb6685201993b | 2026-10-20T08:53:44Z |
|
||||
|
||||
## 证据(Evidence)
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入;手抄/转写输出视为无效证据(AGENTS.md 证据与验证门禁)。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态:未入队;调度记录:无
|
||||
- entry_id:无;attempt_id:无;窗口执行者:无
|
||||
- 固定候选:无(base/head、组件与相关配置引用实际尝试)
|
||||
- 调度依据:policy/delivery.md#合入调度
|
||||
- 固定后证据:源码外 RECEIPT;实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果:
|
||||
- 验证:<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项;逐条证据由 make evidence 写入上方证据表>
|
||||
- 影响与剩余项:
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余:待核对(依据实际成果更新适用方案/规划)
|
||||
- 首选下一任务:待核对(无适用规划、已完成或受阻时如实说明,不虚构任务)
|
||||
- 推荐依据:待填写
|
||||
- 前置条件/待确认:待核对
|
||||
- 预期产物/验收条件:待定义
|
||||
- 重复任务核对:待核对(已有/在途任务、PR 与规划记录)
|
||||
- 启动授权:未授权(建议不自动启动新任务,仍须明确授权)
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录:全新独立 code-reviewer 子智能体(agent 9c6a14b3,fresh_session=true,只接收需求、各仓 base/head 与 diff),结论 **PASS,无阻塞项**:Agent-Squad c0ce10a..c7121bd、Backend c164950..bb9274d、Dev 409f476..76c1c33 均只含指定 gitlink;目标 SHA 均在各自 origin/main;Agent-Native 28f3ea7..2fc66be 实际内容只有 O2 I1;评审者重放 `bash scripts/check-pins.sh` → pins ok(REPLAY)。非阻塞(已处置/记录):① `modules/backend` 改钉顺带引入已在 Backend main 合入的 #222(IAM U5 集成测试,仅测试)与 #223(store 层多用户协作修复)——此后又因扩围引入 #226(其他会话的 CI 不稳定测试修复)与 #227(本任务的 PG 方言测试修复);Dev diff 本身仍只有 gitlink,行为由组合 CI `make test`/`test-pg` 兜底;U5 归档卡“待 bump Dev modules/backend”随本 PR 实际结清(不改该卡)。② check-pins 8 条 development-guidelines/manager 嵌套钉 warn 为既有状态。③ 合入前 task-sync。④ Dev #634 将来需自行解决 modules/backend gitlink 冲突。#227 的测试方言修复由 host 范围审阅并经本 PR 组合 CI `test-pg` 实测。
|
||||
- 冲突记录:NOT_RUN(最新目标同步、冲突处置、组合兼容核验及复审/补测)
|
||||
- CI 记录:@a64a68b `test-pg` 失败(#223 PG 方言缺陷,见探索试验与迭代)与 `test` 失败(npm ECONNRESET);@6b78511 `test`/`test-pg`/`svc-realcombo` 全部 success(组合含 Backend d8923f1)。最终 HEAD 的 CI 见合入记录。
|
||||
- 合入记录(组件连锁):Agent-Squad PR #55 被核验 HEAD `ad58d0ab1a915675e1c7692c0ebb59d48416b655`(CI vet-and-test/docker-checkout-hostgateway/governance success)→ merge `c7121bda2a681dc46078350f7929e56e142db57f`,tree 一致;Backend PR #225 被核验 HEAD `74f655c30ac835920a2d278ebd6dc418280ae01b`(CI vet-and-test/governance success)→ merge `bb9274d737f853474237934bcf25669fd8d6cadb`,tree 一致。两者均只改 gitlink,目标内容(Agent-Native 2fc66be)已在 I1 独立评审。Backend PR #227(扩围修复)被核验 HEAD `803d64e8a2342c6722b696e373c87bc212a62533`(CI vet-and-test/governance success;首轮 `9b23713` 的 vet-and-test 因既有不稳定用例 TestProjectEventsSharedProofAndPrivatePagination 失败,重跑通过)→ merge `d8923f18eceeb476507b09467c0e730ddafc8221`,tree 一致。Dev 合入:待定。
|
||||
- 清理记录:NOT_RUN(授权依据、写者退出确认、worktree/分支/任务卡处置)
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T08:52:56.204072+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"after_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=adbef2f49c",
|
||||
"[remote] origin/main=adbef2f49c ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks(pre-commit/post-merge 实际接线)",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] adbef2f49c(完整:adbef2f49c6c252a09449496afbdb6685201993b)",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区:PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "11058c4bea77919221946183196ce5a97c24fc0bbab8d56ce68de1b1d4ec20ac",
|
||||
"receipt_sha256": "fc66eec2b412ae9a3bfb3afe7f489227201bd35f59c942d555d4dac482e4879f",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/fc66eec2b412ae9a3bfb3afe7f489227201bd35f59c942d555d4dac482e4879f.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录(合入前折叠)
|
||||
|
||||
- 本卡在 PR #653(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/653)合入前闭合并归档,随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填,也无需单独的闭合 PR。
|
||||
| 同步(记录前对象) | a4fa1bb518dd13f2efb9bfab8fdf10e15ddeab22 | b2b45d623faba5770993be35003723500861c752 | 2026-10-20T09:41:50Z |
|
||||
@@ -44,6 +44,7 @@
|
||||
- 智能体完成 Review、解决冲突并确认当前 HEAD 必需 CI 通过后执行合入,无需另请人工操作。
|
||||
- 合入后仅在已登记任务 worktree 根目录、确认所有写者退出后回收;父子仓改动与未跟踪/ignored 唯一文件先保存或处置,删除被拒时保留现场,禁止强删兜底。
|
||||
- 放弃未合入工作用 `make task-finish ABANDON="--abandon <原因>"` 并记录原因,不豁免现场保护。
|
||||
- 每次结束用户任务,最终回复末尾附简短自包含的交接块,供清空上下文后续办;它只是摘要,不替代任务卡、持久交接或证据。无仓库变更也无续办状态时,写一行明确的“不适用”。字段与细则见 [对话收尾交接块](policy/delivery.md#对话收尾交接块)。
|
||||
- 首次克隆后运行 `make setup` 启用本地钩子;治理脚本改动须运行 `make test-governance`(见 [持续回归](policy/governance.md#持续回归))。
|
||||
- 命令与细则:[启动与恢复](policy/governance.md#启动与恢复)、[回收](policy/governance.md#回收)、[两级分支与分流](policy/delivery.md#两级分支交付模型与分流检查)、[分级门禁](policy/delivery.md#层级任务通道与分级门禁)、[合入调度](policy/delivery.md#合入调度)、[Review 与合入](policy/delivery.md#智能体-review-与-pr-合入)。
|
||||
|
||||
|
||||
Vendored
+1
-1
Submodule deps/agent-native updated: 28f3ea7674...2fc66be652
Vendored
+1
-1
Submodule deps/agent-squad updated: 11ff3a0a9c...c7121bda2a
@@ -0,0 +1,48 @@
|
||||
# 快慢通道 O2 I2(Backend `route_contract_eof` 配置与挂载):阶段 6 评审包
|
||||
|
||||
- 状态:**用户阶段 6 通过(2026-10-20)**,并要求启动 I3。Backend #224 已合入 main(`c164950`)。P1 付费探针另提资源方案。
|
||||
- 日期:2026-10-20;作者:host;Dev 任务:`feature/fast-slow-o2-i2-backend`(Dev 草稿 PR [#652](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652))。
|
||||
- 依据:[阶段 4 方案 §4.5](2026-10-19-fast-slow-o2-route-contract-eof-design.md) 与[阶段 5 计划 §3](../plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md);I1 已于 2026-10-20 通过,Agent-Native #48 合入 `2fc66be`。
|
||||
- 交付对象:Backend 草稿 PR [#224](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Backend/pulls/224),base `b5eb89c`(origin/main),head `16f98b8`。
|
||||
|
||||
## 1. 交付内容
|
||||
|
||||
| 计划条目 | 实现 | 位置 |
|
||||
|---|---|---|
|
||||
| 改钉 Agent-Native | `deps/agent-native` `28f3ea7 → 2fc66be`(I1 合入点) | gitlink |
|
||||
| 系统层配置键 | `models.routeContractEOF.model/.baseUrl/.identitySha256`,`SettingScopeSystem`、缺省空;任一为空即关闭;用户/项目层写入被 `ManagedPaths` 剥除 | `internal/settings/settings.go` |
|
||||
| 按身份挂合同 | `routeContractFor(eff, route)`:三项非空、模型名精确相等、`NormalizeRouteBaseURL(route.Base)` 成功且等于配置值、`RouteContractIdentity` 等于摘要,全部满足才挂;只看本 client 实际解析出的 (model, base),不看 `Kind` | `internal/runtime/llm.go` |
|
||||
| 5 个调用点全覆盖 | `llm.go`、`sub_loop.go`、`squad_runner.go`、`verify.go`、`workflow_compiled.go` 统一改用 `openRouteClient(route, eff)`;轻量档、视觉改模、子代理各自独立判定 | 同左 |
|
||||
| 运行记录透传 | Backend 包装器(`annotateKeyFailure`、`GuardProjectStream`、`budgetedStream` 等)原样转发事件,`CompletionBasis`/`TerminalObservation` 不丢;runmgr/store 本来不记录终态观测,无需改 | 测试断言 |
|
||||
| 快慢通道收据透传 | 评测工具按同一规则挂合同(导出薄封装 `runtime.RouteContractFor`);受保护 route 文件可选 `routeContractEOF{…}` 移入系统层;`provider-records.json` 每条记录新增 `completionBasis`,`terminalObservation` 透传 `completionBasis`/`contractCheck`,均按枚举白名单(其它值记 `unknown`,空保持空) | `internal/server/work_checkpoint_eval_test.go`(`live` tag) |
|
||||
|
||||
## 2. 验证
|
||||
|
||||
- 实施:两个 Cursor worker 单元,均经 `agent-exec apply` 快进集成。
|
||||
- `o2-i2-backend-route-contract-config`:attempt 2 success(attempt 1 是 host 把写单元包与派发并行,导致 invalid-config)。
|
||||
- `o2-i2b-eval-receipt-route-contract`:补收据透传,attempt 2 success(attempt 1 因 Cursor CLI 连接中断记为 failed-unknown)。两次重跑均经用户授权。
|
||||
- host 验证(SELF)@`16f98b8`:
|
||||
- `gofmt`、`git diff --check`、`go vet ./internal/runtime ./internal/server`(含 `-tags live`)通过。
|
||||
- `go test ./internal/runtime ./internal/settings -count=1` 通过。
|
||||
- `go test -tags live ./internal/server` 新增 4 个 `TestEvalRouteContract*` 与既有 20 个评测预算/脱敏测试全部通过。
|
||||
- CI(GATE):Backend CI 跑 `go vet ./... && go test ./...`。
|
||||
- `e1a90a5` 已 success。
|
||||
- `16f98b8` success(`ci / vet-and-test` runs/4409、`governance` runs/4410)。
|
||||
- **`live` tag 的评测测试不在 CI 内**,这部分只有 SELF 和独立评审重放。
|
||||
- 独立 Review(全新会话,只接收需求、base/head 与 diff):
|
||||
- 第 1 轮 @`e1a90a5`:PASS-with-fixes。5 条单元验收满足;指出计划 §3 的“快慢通道收据透传”缺失,由第二个单元补齐。
|
||||
- 第 2 轮 @`16f98b8`:**PASS,无阻塞项**。确认生产代码零行为变化,评测判定经真实 settings 服务与生产同源,白名单无泄漏,不匹配时失败关闭,既有断言未删减;评审者重放 `live` 评测测试与 runtime 测试均通过(REPLAY)。
|
||||
|
||||
## 3. 需人审确认与非阻塞项
|
||||
|
||||
1. **小队 agent-native 内核不挂合同**(非阻塞,失败关闭):`internal/app/app.go:350` 用主模型路由直接构造 client,不在计划列出的 5 个调用点内,行为维持今天的拒绝。若希望小队路径也享受合同放行,需另开增量。
|
||||
2. **意图生成器无合同**(无影响):`app.go:519` 不涉及工具放行。
|
||||
3. **调用点接线靠审读确认**(非阻塞):测试注入 `Stream`,没有直接执行 `Execute` 的 nil-stream 分支;判定函数与包装器透传均有直接测试。
|
||||
4. **`baseUrl` 说明措辞**(非阻塞):只写了“无查询串”,未提 fragment/userinfo 同样不匹配。
|
||||
5. **评测配置写错时静默无合同**(非阻塞,建议 P1 前处理):route 文件写了 `routeContractEOF` 但与路由不匹配时,评测按“无合同”运行(安全),但可能白花一次付费请求才发现。建议在 P1 资源方案前,把这种情况改为直接失败,且报错不带配置值。
|
||||
|
||||
## 4. 下一步(通过后)
|
||||
|
||||
1. 合入 Backend #224(组件仓,无需 #518 窗口);Dev #652 收口合入。
|
||||
2. 启动 I3:Dev 改钉 Agent-Native `2fc66be` 与 Backend 合入点,`make test` 组合验证,经 #518 窗口合入。
|
||||
3. P1 付费探针另提资源方案(预算上限、停止条件、收据路径)并单独批准;在此之前不写任何实例的系统层配置。
|
||||
@@ -462,3 +462,25 @@ post-merge 默认只提示,不因 pull 或 merge 自动提交、推送或创
|
||||
|
||||
中断或交接时记录当前有效版本、批准范围、未决假设、最新试验结论、剩余事项及下一动作。
|
||||
恢复后核对现场和授权,从最早未满足的环节续办;不重做仍有效的工作,不省略失效环节。
|
||||
|
||||
### 对话收尾交接块
|
||||
|
||||
每次结束用户任务时,最终对话回复的末尾都附一个简短、自包含的交接块,让对话上下文被清空后,
|
||||
新会话只读这一块和其中的链接就能续办。交接块只是对话层的摘要:权威仍然是任务卡、持久阶段交接
|
||||
(见[有界单元包、上下文与阶段交接](#有界单元包上下文与阶段交接))和 evidence 记录。交接块不替代
|
||||
这些记录或证据,不得把仅写在回复里的内容声称为已记录、已验证,不手抄命令输出,二者不一致时以
|
||||
任务记录为准。
|
||||
|
||||
交接块只写续办所需的最少字段,没有的内容不编造:
|
||||
|
||||
- **目标与授权范围**:本次目标、已授权的动作与写入对象、交付终点。
|
||||
- **当前状态**:已完成、进行中、阻塞或放弃;有仓库时写仓库、分支、HEAD SHA,以及 PR 和任务卡路径。
|
||||
- **关键决定**:影响后续工作的取舍及其依据。
|
||||
- **变更文件**:路径列表,或写明无变更。
|
||||
- **验证与证据状态**:执行过的检查及结果,标注 `SELF`/`GATE`/`REPLAY`,并指向任务卡里的 evidence
|
||||
记录;没有执行的写 `NOT_RUN`,无法复核的写 `[未经证实]`。
|
||||
- **未决事项**:阻塞、待决策点、已登记的非阻塞项。
|
||||
- **下一动作**:一条明确的下一步,或明确写出“已完成,无后续”。
|
||||
|
||||
没有仓库变更、也没有续办状态的工作(例如纯问答或只读解释),只写一行明确的不适用交接,例如
|
||||
`交接:不适用(无仓库变更、无续办状态)`,不为凑齐字段而填充内容。
|
||||
|
||||
Reference in New Issue
Block a user