weichen
2b3b1c6f5b
Align CURRENT via docs apply @document (keep catalog + cursor-governance rows); retain both policy-registry sections and lessons index rows.
9.2 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 与用户后续实施授权，具体授权回链由实施任务保存；审查原文保留历史“待采纳”语境，不改写成执行证据。
本轮规则已通过 7e9317b849e0696e110bac5b27749861178d7e3d 合入 dev 并为 active；包含本修订的受控 dev 集成提交是 effective_commit，从该提交进入 dev 后为 active。集成者在实施任务记录完整 SHA 与验证证据，避免自引用提交散列。读取时先核对该集成提交是否为当前 dev 祖先；尚未集成的规则不能冒充全仓已生效。任务记录读取的 dev SHA 和修订 ID；旧任务集成前比较规则变化，只按已生效规则补齐适用条件。
| 唯一来源 | 范围 | 本轮 revision/state | owner | 生效提交 |
|---|---|---|---|---|
| AGENTS | 任务分级、授权、安全、Git/收口硬边界 | r1 / active | orchestrator_codex | 本修订 dev 集成提交 |
| PROJECT | 仓库地图、环境、工具与模块入口 | r1 / active | orchestrator_codex | 同上 |
| 验证契约 | 测试范围、精确 PI 用例与报告 | r1 / active | orchestrator_codex | 同上 |
| worktree 操作规范 | 创建、租约、共享文档、候选、环境、恢复、清理 | 本轮更新 active；既有规则按历史集成记录 | orchestrator_codex | 本轮实施任务及既有历史交接 |
| Herdr roster | 角色与备援；实际模型/可用性须重新核验 | 既有规则 active；本轮澄清 active | orchestrator_codex | Git 历史及本轮实施任务 |
客户端入口仅指向上述来源；不独立制定第二套测试、提交或凭证规则。外层系统约束及当前用户授权优先，内部冲突按 AGENTS 硬边界、PROJECT 项目细则、专门操作流程的职责解决；仍无法同时满足时记录冲突并请求范围决策。
能力与证据登记
具体工具版本、已验收能力与不覆盖范围由 操作规范 和实施任务中的真实负例验收记录定义。文档/脚本存在不等于 enforced：只有指定版本入口及其测试证明的边界可记 enforced。普通 prose、未接入 hooks、绕过入口的直接文件修改、跨机器权限隔离不得因此声称已被强制。
CURRENT 是带时间的活跃协调快照；Git/机器状态用于核验实际分支、锁与进程，FEATURE-MATRIX 是能力声明，gap-matrix 是发布门禁。审计、方案、历史报告和较新日期均不能自行覆盖上述权威。保留每条结论的范围、提交、环境与日期，避免把旧的通过结论当作当前运行事实。
Herdr v1.2 局部修订
用户已授权采纳经研究修正的资源分工与自动审批。Herdr roster 的角色/额度/客户端参数由 herdr-v1.2 取代旧路由，仅在明确使用 Herdr 时激活，不扩展通用会话工作流。具体来源、验证与生效集成见本轮任务。已通过 dev 合并提交 8c5e3477585fe27a485343dac97a670d95cf8905 生效；profile/dry-run、入口保护和 Kimi 原子计数有隔离验收，真实 Herdr pane 启动未在本轮执行，不将其记为已实测。
系统问题分析局部修订
修订 ID：systemic-issue-analysis-2026-09-23-r1；owner：Codex；state：active（已通过 958dd44fee8bbea8d19129457fc0ad749fdebdbe 合入 dev）；工具能力：manual。用户明确要求将“由个案追查同类根因、潜在问题，研究并提出方案”加入规范，授权与验证见 任务记录。
核心行为唯一来源为 AGENTS 分析要求，验证范围由 验证契约 定义，分析模板 承载证据。客户端继续引用统一入口。生效提交为 958dd44fee8bbea8d19129457fc0ad749fdebdbe，候选验证与受控集成收据见任务记录；不新增业务实施或环境操作授权。
问题记录与经验复用局部修订
修订 ID：issue-learning-2026-09-23-r1；owner：Codex；state：active（已通过 7bbd7a407f857515005c0324d90339017ea5f3e8 合入 dev）；执行能力：manual。用户要求同时管理出现的问题、修复记录和思路，并及时总结为开发注意事项，授权与验证见 任务。
闭环规范 为本流程唯一来源；AGENTS 增加按任务触发的读取/更新入口，模板承载证据，问题台账和经验索引提供检索。生效提交为包含本修订的首个受控 dev 集成提交，以任务收据与 Git 父链核实；未合入不能声称全仓生效。此修订不新增产品功能、自动门禁或运行权限。
CodeGraph 与只读盘点局部修订
修订 ID：codegraph-governance-2026-09-24-r1；owner：Cursor；state：active（生效 tip 19eb56e3744d3c7d4b69b065c87e27689e8caa53 / fixup 0c676afe1faf831020c7c3201509d7cec0328d53）；工具能力：盘点命令与 hooks sync 为 enforced（脚本已落地）；常驻 daemon 装载仍为 manual（本机默认不装载）。用户授权：将 CodeGraph 纳入治理启动/建场/sync，并对 worktree 清理与 FEATURE-MATRIX 做只读盘点提醒（不自动删除、不自动升 done）。
唯一来源增补：AGENTS §1/§4、worktree 操作规范 §8、收口清单。命令入口：agentctl cleanup report、agentctl docs drift、agentctl hooks codegraph-sync、建场 agent-worktree.sh create 的 best-effort codegraph init。不改产品 SWBOOT-10 stub，不装载 systemd coordinator（需另授）。
Subagent 工作流拟议修订
修订 ID：subagent-workflow-2026-09-24-r2；owner：Codex；state：proposed；能力：manual；effective_commit：无。
用户要求研究 Cursor Auto 下的 subagent 分工、阶段流程及报告，授权与本次验收见任务。规范草案为拟议行为的唯一来源，研究报告给出事实和待修冲突，模板承载交接。
用户后续明确采用 Cursor Auto 实施 + gmktec 本机 PI 子任务，并批准默认模型分工及可调整文档。模型配置为模型路由唯一来源，decision_state=approved；流程整体仍 proposed；已批准的模型配置与执行器已合入本地 dev。原 Cursor 原生角色/inherit 方案被替代。执行器已在任务分支实现并验证 Cursor CLI→MCP→PI，代码 69ffaa677e23a1dd9aa0528bb09b3acfcd38b119；运行说明与验证报告限定已验证的机器边界。dev 集成/完整流程审批仍独立记录；不以派发器可用宣称全阶段自动门禁。
Cursor 治理层局部修订
修订 ID：cursor-governance-2026-09-24-r1；owner：Cursor；state：合入 local_dev 后 active（effective_commit 以集成收据为准）；工具能力分层：
- 规则/skill 文本：
manual（Agent 读取执行） - hook 脚本 stdin→stdout 行为：
enforced（scripts/tests/test_cursor_hooks.py） - hook ↔ Cursor IDE 接线：
advisory/manual（事件字段待 probe 采样；见 ISSUE-20260924-cursor-hook-event-contract）
用户授权：在 PI 执行器合入后补齐 skills/rules/hooks；范围与验收见任务。客户端入口：.cursor/rules/cursor-hooks.mdc、pi-subagents.mdc、test-reports-standard.mdc（缩为验证契约指针）；skills pi-subagent-dispatch / subagent-stage-record；hooks 见 .cursor/hooks.json。不改变产品 Runner、不扩大执行器硬门禁语义。
治理目录库与需求重叠检测拟议修订
修订 ID：governance-catalog-2026-09-24-r1；owner：Cursor；state：proposed；能力：schema/门禁落地后为 enforced，向量层 fail-open；effective_commit：无（随受控合入记录）。
用户授权实施跨对话需求重叠检测与治理目录（扩展既有 .locks/state.sqlite，不碰业务 PG）。唯一来源：方案；任务：short-term。策略键 catalog_gate/catalog_vector 为可选，不得破坏 shared_docs 等集合相等校验。