Why: The master record still showed Phases 0-4 as PLANNED after they merged. Evidence: Dev main aee351a/682a4e8, Guidelines main 2688fd2, DM main 183e764, PR #585/#595/#596/#597. Impact: Plan document only. Refs: development-governance-v2 Co-authored-by: Cursor <cursoragent@cursor.com>
7.9 KiB
7.9 KiB
development-governance-v2 统一治理主记录
本文件是治理大任务跨仓状态的唯一汇总。每行状态只取以下值之一,不用笼统的“完成”:
PLANNED / IMPLEMENTED / LOCALLY_VERIFIED / PR_OPEN / REVIEWED / GATE_PASS / MERGED / ADOPTED_ACTIVE / RELEASED / CLOSED。
通过类结论须带来源(GATE / REPLAY / SELF)与对象 SHA;历史对象证据不得充当当前 HEAD 证据。
全局任务只有在全部正式仓达到 ADOPTED_ACTIVE、新项目入口启用、主 PR 全部合入并完成清理后才能标记 CLOSED。
交付主线
| Phase | 内容 | 仓库 / 分支 | PR | 状态 | 依赖 |
|---|---|---|---|---|---|
| 0 | 纠正候选状态、建立本主记录 | Dev feature/development-governance-v2 |
#585 | MERGED | — |
| 1 | Guidelines 合同加固 | Guidelines contract-hardening child → initiative → main | #8、#7 | MERGED(Guidelines main 2688fd2) | — |
| 2 | Dev triage 与两级生命周期整改 | Dev child triage-hardening / target-integrity → initiative | #595、#596 | MERGED(进入 initiative) | 1 |
| 3 | 真实两级 PR 演练 | Dev child PR → initiative → #585 → main | #595、#596 → #585 | MERGED(证据见 Dev 归档卡 feature-development-governance-v2) | 2 |
| 4 | Guidelines 合入 → Dev gitlink → Review → 三项 CI → 合入 #585 → 收口 | Guidelines / Dev | #7 / #585 / #597 | CLOSED(Dev main aee351a;卡片归档 682a4e8) | 1–3 |
| 5 | DM 共享执行器 agent-exec;Dev 薄入口切换与 Python 退役 |
DM #16;Dev feature/dev-shared-executor-switch |
#16 | DM 执行器 MERGED(183e764);Dev 切换进行中(新增 gitlink 场景暴露执行器清点缺陷,DM fix/agentexec-nested-repo-inventory 修复中) |
4 |
| 6 | 存量仓逐仓采纳 | 各仓独立 initiative | — | PLANNED(依赖 DM 治理套件 feature/governance-kit) |
5 |
| 7 | 新项目治理初始化与 CI 准入 | DM feature/governance-kit(K1 triage、K2 start/pr-check、K3 governance init/check) |
— | IMPLEMENTED(K1 已集成)/ 进行中 | 5 |
当前候选对象与历史证据
| 仓库 | 分支 | 对象 | 证据 | 说明 |
|---|---|---|---|---|
| Development-Guidelines | main | 2688fd2 |
PR #7 合入(Review REPLAY + 平台合入) | draft.12 合同与两个 Schema |
| Agent-System-Dev | main | aee351a |
run 3509 三项 CI(GATE,head d648826)+ PI Review(REPLAY) | 两级分支、强制 triage、PR base 门禁 |
| Development-Manager | main | 183e764 |
DM CI(GATE)+ PI Review(REPLAY) | dm-server agent-exec |
已确认阻塞缺陷(整改前)
- Dev
task-triage按接纳中 initiative 数量直接给出JOIN,不做适配判断(违反 KTD1)。 - Dev
task-triage只扫描当前检出的.task/,看不到只存在于远端分支的 initiative(违反 KTD2)。 task-start KIND=child依赖本机已有父分支,未校验父 initiative 仍开放、接纳需求(违反 KTD3)。task-start不要求 triage 收据;无 PR base 门禁;闭合记录与证据未贯穿immediate_target。- Guidelines 缺 terminal receipt 机器 Schema;配置 Schema 未覆盖 transport/admission/豁免/清理;
all-unavailable未与新项目准入隔离;triage 合同仍为数量判定。 - 原 U4 实施方式为 host 预写补丁交 CLI 应用,后续单元须由 CLI 自主实施。
正式仓库清单与采纳矩阵
来源:Gitea /user/repos(2026-10-16 实测)。排除:Agent-System(冻结参考仓,不再开发)、SMDF-Agent-System(空仓)、
governance-drill-2026-09 与 merge-queue-admission-fixture-20261014(演练夹具)。本机 *-wt-*、备份与组合目录不计入。
| 批次 | 仓库 | Guidelines 固定版本 | AGENT-EXECUTION.md | 共享执行器入口 | 正例 | 负例 | Review/CI | 状态 |
|---|---|---|---|---|---|---|---|---|
| A | Development-Guidelines | 自身 | — | — | — | — | — | PLANNED |
| A | Agent-System-Dev | 待更新 | 有(本地 Python 控制器) | 待切换 | — | — | — | PLANNED |
| A | Development-Manager | 待更新 | 无 | 实现方 | — | — | — | PLANNED |
| B | Agent-System-Core | — | 无 | 无 | — | — | — | PLANNED |
| B | Agent-System-Backend | — | 无 | 无 | — | — | — | PLANNED |
| B | Agent-System-RDM | — | 无 | 无 | — | — | — | PLANNED |
| C | Agent-System-Frontend | — | 无 | 无 | — | — | — | PLANNED |
| C | Agent-System-UI | — | 无 | 无 | — | — | — | PLANNED |
| C | Agent-System-Documents | — | 无 | 无 | — | — | — | PLANNED |
| C | Agent-System-Releases | — | 无 | 无 | — | — | — | PLANNED |
| D | Agent-Command | — | 无 | 无 | — | — | — | PLANNED |
| D | Agent-Intent | — | 无 | 无 | — | — | — | PLANNED |
| D | Agent-Native | — | 无 | 无 | — | — | — | PLANNED |
| D | Agent-Squad | — | 无 | 无 | — | — | — | PLANNED |
| E | Error-Code-System | — | 无 | 无 | — | — | — | PLANNED |
| E | Logging-System | — | 无 | 无 | — | — | — | PLANNED |
| E | Agent-Document-Renderer | — | 无 | 无 | — | — | — | PLANNED |
Owner 决策记录
| 日期 | 决策 | 影响 |
|---|---|---|
| 2026-10-16 | cursor 服务端故障期间临时让 agy 成为首选;实际以不含 cursor 包装脚本的 PATH 启动执行器实现(停用 cursor profile 会使 Dev 参考解析器拒绝配置),cursor 冒烟恢复后回到正常 PATH | 无配置改动;收据中 cursor 如实记为 unavailable |
| 2026-10-17 | 共享执行器分发:各正式仓像 Guidelines 一样固定 Development-Manager gitlink(deps/development-manager),薄入口 scripts/agent-exec 构建/运行该固定版本的 dm-server agent-exec;CI 用同一固定版本运行 agent-exec validate |
Phase 6 每仓增加 DM gitlink 与薄入口;Dev Python 实现退役后同样切到该入口 |
| 2026-10-17 | CI 读取私有 Guidelines/DM 子模块所需的 SUBMODULE_TOKEN:owner 授权智能体以 ~/.secrets/gitea 的 API token 作为该 secret 值(只记录来源,不记录值) |
已为 Development-Manager 配置;Phase 6 按需为其他仓配置 |
| 2026-10-17 | Phase 6/7 共享入口:存量仓与新项目没有 Dev 的 task.sh,通用 triage/start/pr-check 与 `governance init | check` 放入 DM(治理套件),各仓经薄入口调用,不复制实现;先完成 Phase 7 套件再用其推进 Phase 6 |
| 2026-10-17 | DM CI 自 2026-09-30 起从未成功(runner 无法拉取 github.com 上的 actions/checkout);按 Dev 已审阅的内联检出模式改为自包含 CI(DM-U6) | Phase 6 中使用 uses: 的仓(Error-Code-System、Logging-System)同样需要检查 |
停止条件
无法获取权威远端 initiative;triage 收据与需求或候选 HEAD 不一致;child PR base 错误;Guidelines gitlink 未指向真实已合入版本; CLI 终态无效或副作用未知;Review、CI 或平台准入缺失;主干在最终 CI 后继续前进;存量仓无共享执行器却启用强制规则; 需要发布规范 tag 而用户尚未执行双钥匙操作。出现任一项即停止对应交付窗口。
用户双钥匙事项
- Development-Guidelines 正式版本 tag:Agent 只准备命令,由用户执行。
- 分支保护变更(如新增必需检查):Agent 只准备方案,由用户执行。