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