weichen
fed87ad14b
Consolidate approved policies and add local lease, document CAS, commit, candidate and environment gates. Preserve conservative recovery and cleanup limits.
3.3 KiB
Agent 规范来源与生效登记
生命周期与权威
proposed → approved → active → deprecated 是规则生命周期；与任务的 planned/in_progress/blocked/done/cancelled 分开。manual/enforced 是工具执行能力，独立于规则状态。规则获批准不证明脚本已经强制执行。
本轮修订 ID：agent-governance-2026-09-21-r1。owner：orchestrator_codex。批准依据：规范审查 R01–R10 与用户后续实施授权，具体授权回链由实施任务保存；审查原文保留历史“待采纳”语境，不改写成执行证据。
本轮规则在任务分支为 approved；包含本修订的受控 dev 集成提交是 effective_commit，从该提交进入 dev 后为 active。集成者在实施任务记录完整 SHA 与验证证据，避免自引用提交散列。读取时先核对该集成提交是否为当前 dev 祖先；尚未集成的规则不能冒充全仓已生效。任务记录读取的 dev SHA 和修订 ID；旧任务集成前比较规则变化，只按已生效规则补齐适用条件。
| 唯一来源 | 范围 | 本轮 revision/state | owner | 生效提交 |
|---|---|---|---|---|
| AGENTS | 任务分级、授权、安全、Git/收口硬边界 | r1 / approved，合入后 active | orchestrator_codex | 本修订 dev 集成提交 |
| PROJECT | 仓库地图、环境、工具与模块入口 | r1 / approved，合入后 active | orchestrator_codex | 同上 |
| 验证契约 | 测试范围、精确 PI 用例与报告 | r1 / approved，合入后 active | orchestrator_codex | 同上 |
| worktree 操作规范 | 创建、租约、共享文档、候选、环境、恢复、清理 | 本轮更新部分 approved，合入后 active；既有规则按历史集成记录 | orchestrator_codex | 本轮实施任务及既有历史交接 |
| Herdr roster | 角色与备援；实际模型/可用性须重新核验 | 既有规则 active；本轮澄清 approved，合入后 active | orchestrator_codex | Git 历史及本轮实施任务 |
客户端入口仅指向上述来源；不独立制定第二套测试、提交或凭证规则。外层系统约束及当前用户授权优先，内部冲突按 AGENTS 硬边界、PROJECT 项目细则、专门操作流程的职责解决；仍无法同时满足时记录冲突并请求范围决策。
能力与证据登记
具体工具版本、已验收能力与不覆盖范围由 操作规范 和实施任务中的真实负例验收记录定义。文档/脚本存在不等于 enforced：只有指定版本入口及其测试证明的边界可记 enforced。普通 prose、未接入 hooks、绕过入口的直接文件修改、跨机器权限隔离不得因此声称已被强制。
CURRENT 是带时间的活跃协调快照；Git/机器状态用于核验实际分支、锁与进程，FEATURE-MATRIX 是能力声明，gap-matrix 是发布门禁。审计、方案、历史报告和较新日期均不能自行覆盖上述权威。保留每条结论的范围、提交、环境与日期，避免把旧的通过结论当作当前运行事实。