weichen/Agent-System-Dev
1
0
Fork 0
Code Issues 1 Pull Requests 3 Actions 2 Packages Projects Releases Wiki Activity

Record unit receipts and re-measurement plan in the task card

Browse Source 
Why: card must carry u3-u9 receipts, requirement table and the M baseline before delivery.
Evidence: receipts under /tmp/govv3-u*-receipt.json (SELF).
Impact: .task only (host-exempt).
Refs: PR #608
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
weichen
2026-10-18 03:04:07 +00:00
co-authored by Cursor
parent 8b769e8462
commit d7e7138ec5
1 changed files with 36 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.task/feature-delivery-model-v3.md
+36 -16
View File
@@ -1,6 +1,6 @@
# feature/delivery-model-v3 任务卡
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
任务主记录：[PR #608](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/608)；状态：进行中；owner：weichen
## 基线与授权
@@ -14,7 +14,7 @@
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
- 当前阶段：实施与自检；当前增量：R（主记录与 L1 建立）
- 当前阶段：正式测试与验收；当前增量：P1–P3 已全部集成，M 已登记
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
## 目标与非目标
@@ -40,38 +40,58 @@ L1 章程（治理大任务）：落实"分层分支交付与规范精简 r1"—
| govv3-u1-doc-proposal（Documents 仓） | docs/proposals/2026-10-18-delivery-model-v3.md、INDEX.md | 76bc59db1d0e | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success → Documents transport c1b0b35，apply 快进；Documents #112 合入 e2f5729 | c1b0b35 | false | /tmp/govv3-u1-receipt.json |
| govv3-u2-dev-proposal-link（第一次运行） | PROJECT.md、modules/documents | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | failed-unknown（单元包要求 git update-index，被判为未解释的 git 管理变更）→ fail-stop | 无 | false | /tmp/govv3-u2-receipt.json |
| govv3-u2-dev-proposal-link-r2（第二次运行） | 同上 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success → transport 10815cb，apply 快进 | 10815cb | false | /tmp/govv3-u2r2-receipt.json |
| govv3-u3-fold-close-self | task.sh close --self、archive 回退查找、文案 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | 2757b6f | false | /tmp/govv3-u3-receipt.json |
| govv3-u4-ci-wait-parallel-submodules | scripts/ci_wait.py、make ci-wait、--jobs 8 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | b7f6a8b | false | /tmp/govv3-u4-receipt.json |
| govv3-u5-light-ci-test-affected（第一次运行） | ci.yaml、test_affected、ci_wait 修正 | — | implementation | cursor, antigravity, pi | 0（未启动） | — | invalid-config（单元包含疑似敏感路径名 tests/test_ci_credentials.py）→ fail-stop，无副作用 | 无 | false | /tmp/govv3-u5-receipt.json |
| govv3-u5-light-ci-test-affected-r2 | 同上（去除该路径） | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | fb4c89d | false | /tmp/govv3-u5r2-receipt.json |
| govv3-u6-task-start-light-child-templates | task.sh 子任务免分流、自动 precheck、三模板 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | 9a3ef83 | false | /tmp/govv3-u6-receipt.json |
| govv3-u7-lanes-level-gates-doc | policy/delivery.md 层级/通道/门禁 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | 48a8029 | false | /tmp/govv3-u7-receipt.json |
| govv3-u8-evidence-summary-in-card | evidence 摘要入卡、完整收据源码外、check-evidence | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | a28318c | false | /tmp/govv3-u8-receipt.json |
| govv3-u9-slim-spec | AGENTS.md 入口化、合入调度并入 delivery.md、去重 | caefcb72b970 | implementation | cursor, antigravity, pi | 1 | cursor (cursor-agent-stable) | success，apply 快进 | 8b769e8 | false | /tmp/govv3-u9-receipt.json |
- u2 第一次运行对账：规范检出未变、无 transport、私有工作区保留；处置：单元包改用既有 gitlink 提升模式（本地 clone --no-checkout 后 detach，禁止 submodule/add/update-index），全新派发。
- Documents #111（host 直写 docs/proposals，不在豁免路径内）已关闭并删除分支，改由 u1 撰写。
## 关联方向与规划
- 适用状态：待核对（无适用规划时说明原因）
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
- 对应里程碑：待核对
- 适用状态：适用
- 主记录路径/版本：modules/documents/docs/proposals/2026-10-18-delivery-model-v3.md @ Documents e2f5729（PROJECT.md 规划首条链接）
- 对应里程碑：交付模型 v3（分层分支交付与规范精简）
## 需求分析
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|---|---|---|---|---|---|---|
| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 |
| R1 | 任务卡合入前折叠闭合（P1） | 闭合 PR 约占 main 推进 40% | P1 | close --self 可用，查找回退仅限 PRE_MERGE_CLOSED，测试覆盖 | — | 已实现（u3） |
| R2 | 统一 CI 等待与子模块并行物化（P1） | 长 sleep 占用会话时间 | P1 | make ci-wait 快速失败/双次全绿确认；--jobs 8 | — | 已实现（u4、u5） |
| R3 | 门禁按层级分配（P2） | L2→L1 不应跑完整重 CI | P2 | 非 main base 的 PR 跳过 test-pg/svc-realcombo；test-affected；登记子任务免分流 | R1 | 已实现（u5、u6） |
| R4 | 任务通道与 L1 章程（P2） | 修复优先、两层上限 | P2 | delivery.md 层级/通道/门禁表 | — | 已实现（u7） |
| R5 | 证据摘要入卡与规范精简（P3） | 归档卡中位 113 KB | P3 | 卡内只存摘要；AGENTS.md 入口化；合入调度单一权威 | — | 已实现（u8、u9） |
| R6 | 复测计划（M） | 验证收益 | P3 | 基线、方法、日期登记在案 | R1–R5 合入 | 已登记（见下节） |
## 方案与计划
- 方案引用：待填写（含对象版本）
- 实施计划引用：待填写（含增量与需求 ID）
- 测试计划引用：待填写（含需求 ID 与验收条件）
- 方案引用：计划"分层交付与规范精简"（用户 2026-10-18 批准）；主记录 Documents e2f5729
- 实施计划引用：单元 u1–u9（见 Agent 实施收据），对应 R1–R6
- 测试计划引用：各单元直接测试（tests/test_task*.py、test_evidence、test_check_evidence、test_ci_wait、test_test_affected、test_check_worktree）；最终 HEAD 的 CI（make test + make build）为 GATE
## 复测计划（M）
- 执行日：本 L1 合入 main 后两周（约 2026-11-01）；执行者：下一次治理会话。
- 基线（2026-10-18 采集，来源 SELF：git log 与 Gitea actions tasks API）：14 天 main first-parent 推进 410 次（峰值 85/天，合入窗口引入后约 17/天）；3.3 天 200 次 CI 运行，中位 8.3 分钟；闭合相关运行约占机时 31%；每 PR 平均 2.4 次 CI；闭合 PR 约占 main 推进 40%；归档卡中位 113 KB。
- 方法：`git log --first-parent --since=<14天前> origin/main --oneline | wc -l`（按日分组）；`GET /api/v1/repos/weichen/Agent-System-Dev/actions/tasks?limit=N` 统计运行次数、run_started_at→updated_at 机时与 event；按 PR 统计 CI 次数及排队/等待时长；`.task/archive/` 新卡大小中位。
- 判定：main 推进与闭合相关机时明显下降、每 PR CI 次数不升；否则回到主记录复盘。
## 阶段记录
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|---|---|---|---|---|---|
| 需求拆解 | 待定 | 待执行 | — | — | — |
| 需求评估 | 待定 | 待执行 | — | — | — |
| 需求表确认 | 待定 | 待执行 | — | — | — |
| 方案设计 | 待定 | 待执行 | — | — | — |
| 实施计划 | 待定 | 待执行 | — | — | — |
| 实施与自检 | 待定 | 待执行 | — | — | — |
| 需求拆解 | 计划 r1 | 完成 | host（Cursor 主模型） | 2026-10-18 | 计划"分层交付与规范精简" |
| 需求评估 | 计划 r1 | 完成 | host | 2026-10-18 | 基线数据见复测计划（M） |
| 需求表确认 | 计划 r1 | 完成 | 用户批准 | 2026-10-18 | "Implement the plan as specified" |
| 方案设计 | Documents e2f5729 | 完成 | u1（cursor） | 2026-10-18 | Documents #112 |
| 实施计划 | u1–u9 单元包 | 完成 | host | 2026-10-18 | Agent 实施收据表 |
| 实施与自检 | 8b769e8 | 完成 | u2–u9（cursor）+ host 直接检查 | 2026-10-18 | 单元收据；host 复跑 test_task*/test_evidence/test_ci_*/test_test_affected |
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
| 代码 Review | 待定 | 待执行 | — | — | — |
| 合入 | 待定 | 待执行 | — | — | — |
@@ -100,7 +120,7 @@ L1 章程（治理大任务）：落实"分层分支交付与规范精简 r1"—
- 调度状态：未入队；调度记录：无
- entry_id：无；attempt_id：无；窗口执行者：无
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
- 调度依据：policy/merge-queue.md；新模式启用前按既有交付门禁
- 调度依据：policy/delivery.md#合入调度（原 policy/merge-queue.md）；新模式启用前按既有交付门禁
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
## 结果与验证（完成后填写）