--- title: "落实 Agent 规范与 L1 操作门禁" status: in_progress 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: approved integration_state: pending deployment: not_required cleanup: pending 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 仓库。 ## 验收 - [ ] 新规范一致、轻量入口和真实状态可用;历史迁移不丢失。 - [ ] 主仓唯一 .locks;原子资源集合、父子冲突、活跃/失效身份、幂等及保守恢复。 - [ ] CURRENT/MATRIX 受控增量/CAS 更新,旧基线不覆盖,记录恢复证据。 - [ ] 错误工作区/无租约服务写入被拒;候选镜像源码 SHA 不符被拒。 - [ ] 安全 create/remove、commit/ref 门禁正反例通过。 - [ ] 独立代码审查及真实临时仓库并发验收;本地 dev 接收验证后的候选;安全清理。 ## 交付边界 L1 对统一入口与 Git hooks 防误改,不能阻止任意同 UID shell 绕过。OS 沙箱、跨机锁、产品 PI 镜像交付等独立运行架构变更不在本次规范/最小门禁改动内。纯工程代码与文档不触发产品重建;将验证主目录运行挂载和就绪未因本轮改变。 ## 验证与集成进度 - 76 项 Python 工程测试通过;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)。 - 候选待基于最新 dev 构造;期间 Cursor 的材料切块任务推进 dev,保留其 CURRENT 增量和验收记录。 - 主机部分同 UID 进程 cwd 不可读,保守清理可能 pending;证据与接管责任随收口更新。