Files
Agent-System/.doc/ops/short-term/2026-09-24-cursor-governance-hooks.md
T

3.8 KiB
Raw Blame History

title, task_id, status, created, updated, owner, task_type, task_tier, policy_revision, branch, worktree, base_dev_sha, write_scope, allowed_environments, mutex, review_state, integration_state, deployment, cleanup, cleanup_owner, cleanup_trigger, remote_sync
title task_id status created updated owner task_type task_tier policy_revision branch worktree base_dev_sha write_scope allowed_environments mutex review_state integration_state deployment cleanup cleanup_owner cleanup_trigger remote_sync
Cursor 治理层扩展(rules / skills / hooks) cursor-governance-hooks-2026-09-24 done 2026-09-24 2026-09-24 Cursor implementation multi_stage agent-governance-2026-09-21-r1 + issue-learning-2026-09-23-r1 + codegraph-governance-2026-09-24-r1 + subagent-workflow-2026-09-24-r2(proposed); base_dev@cfc80b34a40e8de78e77a44839571bb684d405d5 feature/cursor-governance-hooks-2026-09-24 .worktrees/cursor-governance-hooks-2026-09-24 cfc80b34a4
.cursor
scripts/tests
.doc
cursor-governance accepted merged_local_dev not_required pending owner 退出后的独立维护者 合入 local_dev、证据归档且 owner 退出后复查 not_requested

Cursor 治理层扩展(rules / skills / hooks)

用户目标与授权

  • 用户目标:在已合入的 PI subagent 执行器基础上,为本项目 Cursor 补齐 skills、rules、hooks 等治理层。
  • 授权来源:本会话确认计划 cursor_governance_layer,范围含 7 项全选、hook 命中一律 ask、session+postToolUse 双轨、字段识别 both_phases。
  • 交付终点:任务分支实现并通过工程回归;受控合入 local dev;不 push;不重建产品服务。
  • 禁止:未授权 push / 晋升 test/main;改产品 Runner;以 stub 冒充产品 PASS;覆盖他人 CURRENT/MATRIX。

范围与非目标

  • 允许:.cursor/rules|skills|hooks|mcp.json、scripts/tests/test_cursor_hooks.py、相关 .doc(任务/台账/经验/规范登记/测试报告)。
  • 非目标:改 scripts/pi_subagents.py 硬门禁语义;实现 S0–S9 自动状态机;产品 Go/前端/PG。

相关问题与经验

  • ISSUE-20260924-cursor-test-rule-drift(open → verifying)
  • ISSUE-20260924-cursor-cli-mcp-path(deferred → verifying)
  • 新建 ISSUE-20260924-cursor-hook-event-contract(open)
  • 采纳 LESSON-20260923-matrix-status-cas、LESSON-20260924-pi-tool-boundaries;新建 LESSON-20260924-cursor-hook-advisory-gates(candidate)

需求与验收

R-ID 要求 AC-ID
R1 修复测试规则漂移 AC1:无固定模型/无条件全量 Go/失效 §8;指向验证契约
R2 PI 派发 skill AC2:roles→run→result、租约、拒绝码、run_status≠verdict
R3 阶段记录 skill AC3:派发包/回传/收据/R-AC-T 可执行
R4 PI/会话/收据 hooks AC4:ask;fail-open 异形;probe 开关;单元可测
R5 MCP 路径 AC5:agentctl/jev 相对路径;CLI 证据或 verifying
R6 rules 收敛与登记 AC6:薄指针 + policy-registry 修订
R7 工程回归 AC7:unittest discover 全绿;文档静态检查;报告归档

步骤与验收

  1. 建场与认领
  2. 规则漂移修复
  3. 两 skill
  4. 四 hook + hooks.json
  5. MCP 路径
  6. rules 收敛
  7. 测试与全量回归
  8. ISSUES/lesson/policy-registry
  9. 测试报告
  10. probe 独立验收(需用户配合;未采样前 advisory)
  11. 受控合入 local_dev

验证与证据

见后续测试报告与本记录更新。产品链路 NOT REQUIRED。

相关链接

  • 计划:用户确认的 Cursor governance layer
  • 权威:.doc/ops/2026-09-24-subagent-model-config.md · 2026-09-24-subagent-workflow-standard.md · 2026-09-24-pi-subagent-executor.md · 2026-09-21-validation-contract.md

收口(合入后)

  • review_state=accepted;integration_state=merged_local_dev(57cbd571);deployment=not_required;cleanup=pending;remote_sync=not_requested
  • validate:208 tests OK;enqueue daemon ff-only 成功
  • IDE probe 仍为 pending_ide_sample;hook↔Cursor 接线保持 advisory