Files
Agent-System-Dev/docs/superpowers/plans/2026-10-16-development-governance-v2-master.md
T
weichenandCursor fb88e77038 Refresh the governance master record through Phase 5
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>
2026-10-17 04:46:44 +00:00

7.9 KiB
Raw Blame History

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

已确认阻塞缺陷(整改前)

  1. Dev task-triage 按接纳中 initiative 数量直接给出 JOIN,不做适配判断(违反 KTD1)。
  2. Dev task-triage 只扫描当前检出的 .task/,看不到只存在于远端分支的 initiative(违反 KTD2)。
  3. task-start KIND=child 依赖本机已有父分支,未校验父 initiative 仍开放、接纳需求(违反 KTD3)。
  4. task-start 不要求 triage 收据;无 PR base 门禁;闭合记录与证据未贯穿 immediate_target。
  5. Guidelines 缺 terminal receipt 机器 Schema;配置 Schema 未覆盖 transport/admission/豁免/清理;all-unavailable 未与新项目准入隔离;triage 合同仍为数量判定。
  6. 原 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 只准备方案,由用户执行。