--- title: "落实 Agent 规范与 L1 操作门禁" status: done created: 2026-09-21 updated: 2026-09-21 owner: Codex branch: feature/agent-governance-implementation worktree: .worktrees/agent-governance-implementation base_dev_sha: a241e838150f218f3a09d3523f93291b847d45fd mutex: agent-governance review_state: passed integration_state: integrated deployment: not_required cleanup: pending cleanup_owner: independent-maintainer-after-owner-exit remote_sync: not_requested --- # 落实 Agent 规范与 L1 操作门禁 用户已授权“按照方案实现这些规范”。范围：审查 R01–R10、两项安全补充、两个共享文档与 dev 操作的 L1 管理入口。所有修改在本任务 worktree；不改产品业务代码、数据库、模型配置，不升级 test/main，不 push。Python 标准库 sqlite3/fcntl 实现本机协调，不增加产品 Go 依赖。 ## 实施单元与所有权 - 规范 Agent：AGENTS/PROJECT/客户端薄入口/模板/测试规范/CURRENT 归档，互斥 policy-docs。 - 工具 Agent：worktree helper、env-service、candidate-images-build 与对应测试，互斥 ops-scripts。 - 根 Agent：agentctl/SQLite/lease/CAS/提交与集成门禁、runbook、报告、FEATURE-MATRIX、ignore，互斥 coordination-core。 - 测试 Agent：核心独立行为测试，仅写自己的测试文件，使用临时 Git 仓库。 ## 验收 - [x] 新规范一致、轻量入口和真实状态可用；历史迁移不丢失。 - [x] 主仓唯一 .locks；原子资源集合、父子冲突、活跃/失效身份、幂等及保守恢复。 - [x] CURRENT/MATRIX 受控增量/CAS 更新，旧基线不覆盖，记录恢复证据。 - [x] 错误工作区/无租约服务写入被拒；候选镜像源码 SHA 不符被拒。 - [x] 安全 create/remove、commit/ref 门禁正反例通过。 - [x] 独立代码审查及真实临时仓库并发验收；本地 dev 接收验证后的候选；安全清理。 ## 交付边界 L1 对统一入口与 Git hooks 防误改，不能阻止任意同 UID shell 绕过。OS 沙箱、跨机锁、产品 PI 镜像交付等独立运行架构变更不在本次规范/最小门禁改动内。纯工程代码与文档不触发产品重建；将验证主目录运行挂载和就绪未因本轮改变。 ## 验证与集成结果 - 76 项 Python 工程测试通过；最终候选复跑同样 76 PASS。20 个真实进程/独立 Git worktree 争同一资源：1 个执行、19 个 LOCK_BUSY。 - ce-simplify-code 三视角完成；ce-code-review `20260921-133611-5e4781e6` 的 5 个确认问题全部修复并经独立复核关闭。详见[报告](../../test-reports/2026-09-21-agent-governance-test-report.md)。 - 源码实现提交 `fed87ad1`；保留并行 Cursor 材料切块任务后任务 HEAD 为 `578a96440da56717582ec5ab267a094ceea3d941`。dev 从 `a5ea469ca44171a5c3e6419b1757852270fb991d` 接收完整验证候选 `7e9317b849e0696e110bac5b27749861178d7e3d`，这是规则 effective_commit。 - 主仓 `.locks` 初始化、旧/新 dev flock 同 inode 和三个 hooks 已启用；doctor 正常，无租约 env guard 返回 LEASE_REQUIRED。收口文档使用已生效入口完成 CAS、提交与后续候选集成。 - 真实 dev 合入前后 ready=ok/schema61、容器镜像和主目录 data/dev 挂载一致。本轮 deployment=not_required；未 push、未操作 test/main、无产品数据库或模型配置改动。 - cleanup=pending：实际普通 remove 因部分同 UID 进程 cwd 不可读拒绝。保留本任务及 integrate-agent-governance-implementation 两个工作区，不使用 force/-D。独立维护者在 owner 退出并解决/核实进程可见性后重跑全部门禁；仅含可再生 pycache 的文件先明确删除。其他任务现场不在清理范围。 - 文档链接检查 356 个目标中，唯一已存在的 `FEATURE-MATRIX` 历史 promotion receipt 断链不由本轮引入；本轮新增/修改链接全部有效。