diff --git a/.task/feature-delivery-model-v3.md b/.task/feature-delivery-model-v3.md index 50a418dc..680288d9 100644 --- a/.task/feature-delivery-model-v3.md +++ b/.task/feature-delivery-model-v3.md @@ -1,6 +1,6 @@ # feature/delivery-model-v3 任务卡 -任务主记录：；状态：进行中；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；实际结果后按授权原样导入和闭合 ## 结果与验证（完成后填写）