Agent-Squad/.task/archive/feature-governance-adoption.md

# Agent-Squad 采纳 development-governance-v2 治理套件 任务卡

任务主记录：[Agent-Squad PR #54](https://git-home.u1680832.nyat.app:30319/weichen/Agent-Squad/pulls/54)（本文件随 PR 描述维护）。
状态：已完成（闭合随本 PR 合入；合入以平台记录为准）；owner：weichen。

## 基线与授权

- 权威仓：weichen/Agent-Squad；root_target：main；immediate_target：main
- branch_kind：initiative；initiative_id：governance-adoption-Agent-Squad
- R0（initial_main_sha）：490b0b2dfa1567cb16ff7a7230fd78e52bc2938e；工作区：/home/weichen/projects/Agent-Squad-wt-feature-governance-adoption（worktree）；分支：feature/governance-adoption
- 父任务信息（仅子任务填写）：无
- accepting_requirements：false（单仓采纳 initiative，范围固定为下列十步，不接收新需求）
- 需求分流：verdict=NEW；selected_initiative=无；候选=无；理由=development-governance-v2 Phase 6 每个正式仓库独立 initiative；triage 收据=无（本仓采纳前尚无 triage 入口）
- 授权与交付终点：owner 已授权 development-governance-v2 全部实施（Agent-System-Dev 主记录 docs/superpowers/plans/2026-10-16-development-governance-v2-master.md）；终点为本 PR 合入 main 且采纳状态 active。分支保护与 tag 由用户执行。
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md；外部 Agent 一单元一新进程/会话/工作区）

## 目标与非目标

目标（Phase 6 十步）：固定 Guidelines SHA（deps/development-guidelines @ 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb）；增加 AGENT-EXECUTION.md；增加共享执行器薄入口（deps/development-manager @ bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c + scripts/dm、scripts/agent-exec、scripts/task）；四条路由（implementation/repair/test/review）；任务卡模板与分支元数据；CI 中启用 schema 校验（.gitea/workflows/governance.yml：agent-exec validate + governance check）；一次正例运行；负例（缺配置、坏收据、越界路径、未知副作用）；独立 Review + CI；采纳状态 active。

非目标：不改业务代码与既有测试；不改分支保护（由用户执行）；不发布 tag。

范围说明（Review 阻塞项 2）：`scripts/submodule-consistency.sh` 要求 deps/agent-native、deps/agent-intent 内嵌的 Guidelines/错误码/日志 gitlink 与本仓一致；本 PR 把 Guidelines 固定到 2688fd2 后，按最小修复把这两个 gitlink 升到各自已合入治理采纳的 main（Agent-Native 14d4869、Agent-Intent 651a2e1；两者相对原固定版本只增治理文件、不改 Go 代码），其余 gitlink 不动。核对见证据 `scripts/submodule-consistency.sh`。

引导说明：AGENT-EXECUTION.md 由 host 以固定版本治理套件（dm-server governance init @ bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c）生成并作为引导配置提交（执行器运行前必须存在有效配置；沿用 DM 采纳先例）；其余文件由实施单元生成。

## Agent 实施收据

| 单元 ID | 预期范围 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|---|---|---|---|---|---|---|---|---|---|
| governance-adoption-Agent-Squad-r1 | 13 个允许路径（治理文件 + 两个 gitlink） |  | implementation | cursor→antigravity→pi | run 71696608（dm-server pinned，attempts=1） | cursor / not-observable | failed-unknown | 无（apply 快进） | 否 | /tmp/gov-receipt-Agent-Squad-r1.json |
| 对账（r1） | 规范 worktree 仍为 2a2a1fd 且干净；无 transport ref | — | — | — | — | — | 已对账；全新运行 r2（单元包追加禁止固定共享 /tmp 路径约束） | — | — | — |
| governance-adoption-Agent-Squad-r2 | 13 个允许路径（治理文件 + 两个 gitlink） | b83905a8 | implementation | cursor→antigravity→pi | run 145e30ce（dm-server 42e675f，attempts=1） | cursor / not-observable | success | 468878f62ede（apply 快进） | 否 | /tmp/gov-receipt-Agent-Squad-r2.json |
| （无效启动 repair-r0） | — | repair | — | 无 attempt | — | invalid-config（单元包尚未写出即启动，执行器读取失败；无 attempt、无副作用，worktree 仍为 e29284e 且干净） | 无 | 否 | /tmp/gov-receipt-Agent-Squad-repair-r0-invalid-unit-path.json |
| governance-adoption-Agent-Squad-repair-r1 | policy/guidelines-adoption.md、PROJECT.md、deps/agent-native、deps/agent-intent | repair | cursor→antigravity→pi | run fadb9c92（attempts=1） | cursor / not-observable | success | d0f9081f47eb（apply 快进） | 否 | /tmp/gov-receipt-Agent-Squad-repair-r1.json |

## 同步记录

| 节点 | sync_base_sha | tested_head_sha | checked_at | 结果 |
|---|---|---|---|---|
| 启动 | 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e | 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e | 2026-10-17T07:17:41Z | 一致 |

## 结果与验证（完成后填写）

- 结果：治理套件已采纳——Guidelines 与 Development-Manager gitlink 固定、AGENT-EXECUTION.md 四条路由、共享执行器薄入口、pre-commit admit、governance CI；采纳状态 active（随合入生效）。
- 验证：见下表（命令输出由 /tmp/gov-neg/ev.sh 写入 .task/evidence/governance-adoption/，SELF 除非另注）。
- 影响与剩余项：不改业务代码；本地启用钩子需由人执行 `git config core.hooksPath scripts/hooks`；将 governance 检查设为分支保护必需项属用户双钥匙事项（命令见 Agent-System-Dev 治理主记录）。

| 时间(UTC) | 命令 | 被测 HEAD | exit | 来源 | 摘要/位置 |
|---|---|---|---|---|---|
| 20261017T080150Z | `scripts/dm governance check --repo .` | 468878f62ede | 0 | SELF | ok fixtures；[输出](../evidence/governance-adoption/00-20261017T080150Z.log) sha256:b07d207012a2fd6d |
| 20261017T080150Z | `scripts/agent-exec validate --repo .` | 468878f62ede | 0 | SELF | validate: ok；[输出](../evidence/governance-adoption/01-20261017T080150Z.log) sha256:b3a91246221bb5f8 |
| 20261017T080150Z | `python3 /tmp/gov-neg/adopt_cases.py .` | 468878f62ede | 0 | SELF | [verdict] ALL PASS cases=5；[输出](../evidence/governance-adoption/02-20261017T080150Z.log) sha256:109906d5e57fe039 |
| 20261017T094306Z | `scripts/dm governance check --repo .` | d0f9081f47eb | 0 | SELF | ok fixtures；[输出](../evidence/governance-adoption/03-20261017T094306Z.log) sha256:b904686133da5f80 |
| 20261017T094306Z | `scripts/agent-exec validate --repo .` | d0f9081f47eb | 0 | SELF | validate: ok；[输出](../evidence/governance-adoption/04-20261017T094306Z.log) sha256:19dc223efda318d6 |
| 20261017T094308Z | `scripts/submodule-consistency.sh` | 05b509827274 | 0 | SELF | ok deps/agent-intent 651a2e1e03c4326888ef9f742ce592140ae30ab8；[输出](../evidence/governance-adoption/05-20261017T094308Z.log) sha256:bc528fe029ed41d2 |
| — | 候选 HEAD CI | b3e7da4a11b9 | 0 | GATE | success ci / docker-checkout-hostgateway (pull_request)=success（/weichen/Agent-Squad/actions/runs/3672/jobs/5787）；governance / governance (pull_request)=success（/weichen/Agent-Squad/actions/runs/3673/jobs/5788）；ci / vet-and-test (pull_request)=success（/weichen/Agent-Squad/actions/runs/3672/jobs/5786） |
| — | 独立 Review | b3e7da4a11b9 | 0 | REPLAY | cursor-agent-stable --mode ask 全新只读会话（fresh_session=true，session id not-observable）闭合重审 VERDICT: APPROVE（对象 b3e7da4） |