5.2 KiB
5.2 KiB
CLI/git 门禁能力矩阵
适配对象：通过 shell/git 操作本仓的执行者。要求来自固定的 Development-Guidelines
standards/tool-adaptation.md 与根 AGENTS.md；本表登记机制范围，不复制另一套规则。
历史治理可靠性记录见 .task/feature-governance-reliability.md；本轮调度与恢复候选的
实际 SELF 命令记录见 .task/feature-merge-queue-policy-draft.md。历史测试不代替当前对象回归。
| 要求 | 执行能力及范围 | 机制 | 复验入口 |
|---|---|---|---|
| A1 启动/恢复 | 本地命令阻断；首次收据必需，不创建阶段人工停顿 | 默认严格 READY；显式 local 验证既有任务/R0及 LOCAL_READY；start 固定严格用途，resume 验证后导入 | tests/test_task.py、tests/test_task_recovery.py、tests/test_evidence.py |
| A2 同步 | 本地命令阻断；最终准入由平台承担 | 合并父仓、保护组件分支、物化固定指针、同基线幂等、完整最终 SHA | tests/test_task.py、make test-worktree |
| A3 集成分支 | 本地提交闸；平台状态须独立核验 | pre-commit 拒绝 main/master 与坏分支名 | 本地 hook 负例；远端缺 CI/陈旧候选/直推等负例另验 |
| A4 提交格式 | 主题行 enforced(local)，body manual | commit-msg 校验宽度/句点；任务工具生成四段 body | tests/test_task.py；智能体核对 PR/卡片同源 |
| A5 回收 | 本地命令检查；写者退出须可证明，无法证明时才请求 owner 决策 | 登记根目录、锁/操作状态、父子仓与唯一文件、合入核验 | tests/test_task.py |
| A6 秘密 | 本地脱敏及 CI 获取边界；权限与宿主隔离另验 | 命令/输出/摘要脱敏，凭据不持久写 Git 配置 | tests/test_evidence.py、tests/test_ci_credentials.py |
| A7 证据 | 本地 SELF 收据；外部来源独立核验 | 首次捕获、完整脱敏输出/摘要、对象记录、原样导入 | tests/test_evidence.py；CI/审阅链接另核 |
| A8 阶段记录与迭代 | goal-first + agent-per-unit（AGENT-EXECUTION.md）；模板默认连续执行，仅真实决策点需人工，没有全流程授权强制；实施/修复/测试仅 Cursor、agy、PI，每候选对安全可恢复失败最多 3 次全新尝试，全部安全耗尽后一次 Codex CLI 紧急尝试；Codex 平时仅规划、设计、计划或独立 Review；显式 fail-stop 立即停止；不限制推理时长、工具次数、规划方式或首次写文件时间；集成经成功 transport 的 agent-exec apply，或 pre-commit admit 精确内容来源；host 豁免仅为 .task/** 与 docs/superpowers/specs/、plans/；host 不直接实施；fallback_to_host 为 never；安全耗尽不发出 host-fallback-authorized，终态为 unavailable 或 blocked | policy/delivery.md、AGENT-EXECUTION.md；任务卡分别记录阶段状态、决策点、Agent 实施收据（配置摘要/角色/候选/attempt/CLI-模型/终态/transport/紧急尝试/源码外路径）、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | tests/test_task.py 核对 goal-first/agent-per-unit 模板、正常路由、尝试上限、fail-stop、空闲超时与 apply/admit 来源表述，及钩子不自动写入；scripts/agent-exec validate（CI）与 parser·adapter·controller 假 CLI 契约（Development-Manager internal/agentexec 测试，经 deps/development-manager 钉住）为本地 SELF 强制行为；已安装 provider/model 身份待 U5，远端平台准入为 GATE；智能体核对授权范围、实施单元边界、Review、冲突及匹配 HEAD 的 CI/平台准入 |
| A9 长期方向与后续任务 | manual；模板不校验规划有效性或自动调度任务 | policy/delivery.md；PROJECT.md 提供规划入口，任务卡关联规划/里程碑并记录下一步建议 | tests/test_task.py 核对生成字段与未授权默认值；智能体核对当前规划、进展、重复任务和建议依据，新任务仍不自动获得授权 |
| A10 交付窗口 | manual；无自动互斥或接管 | 合入调度与 #518：同一目标一个最终窗口，等待分支不追 main；轮到后同步、固定、验证并由智能体合入 | 每个实际 PR 核对窗口记录、精确 HEAD 三项 GATE、Review 和合入后 main；不要求额外试行或全写者审计 |
| A11 固定后证据 | manual 选择源码外位置；工具捕获绝对未用路径/原始输出；无 OS 冻结 | policy/governance.md；RECEIPT 捕获，后续授权闭合再原样导入 | tests/test_evidence.py 固定对象、权限、覆盖拒绝、原样导入与幂等 |
失败处理
网络不可达、引用缺失、必要解释器不可用均显式失败，不能给 READY 或同步成功。 命令非零、管道失败及证据写入失败返回非零；保留已有收据，不覆盖历史结果。 工作区回收被拒时保留现场；本地及远端回收分开报告。具体操作见 开发门禁。
平台与历史证据
2026-09-30 记录曾报告 11 个组合仓 main 已启用禁直推与陈旧候选保护；这是历史结论， 本次代码/文档修复不据此认定当前远端准入有效。正式审核仍须核验当前配置和匹配负例， 与本地回归分开记录。机制升级只复用未变化范围的证据。