weichen
5618cfc8cf
Layer advisory Cursor hooks and skills on the PI executor, shrink the test-report rule to the validation contract, and fix MCP relative paths.
25 lines
1.7 KiB
Plaintext
25 lines
1.7 KiB
Plaintext
---
|
||
description: Route PI analysis/review/test subagent work through scripts/pi_subagents.py (not Cursor native agents).
|
||
alwaysApply: true
|
||
---
|
||
|
||
# PI subagents（工程工具）
|
||
|
||
本机 PI 子任务走 `scripts/pi_subagents.py` + 模型配置 `.doc/ops/2026-09-24-subagent-model-config.md`。可执行步骤见 skill `pi-subagent-dispatch`；阶段记录见 `subagent-stage-record`。
|
||
|
||
## 自动派发（主 Agent）
|
||
|
||
1. **预览配置**：`pi_subagent_roles` / CLI `roles`（不调模型）。
|
||
2. **按阶段选角色**：research → planning → reviews → diagnosis → test_run / acceptance_check → report；实施/修复仍由 Cursor Auto。
|
||
3. **派发 `run`**：携带 task_id、role_id、唯一 request_id、goal、authorization_ref、冻结 source_sha、input_files、timeout；test 角色另附 approved_commands + plan_digest。
|
||
4. **租约**：报告路径 `path:.doc/test-reports/assets/pi-subagents/<task>/<request>`；裸调拒绝。
|
||
5. **取回**：`pi_subagent_result` / CLI `result`；`run_status` 与 `verdict`/`review_state` 分离——模型成功仅 `pending`，测试 pass 仅来自批准命令证据。
|
||
6. **门禁**：审查/测试结论须带回报告路径与 receipt 字段；不得用模型叙事冒充 PASS。
|
||
|
||
## 边界
|
||
|
||
- **Cursor Auto**：唯一代码实施车道；本规则不把 implementation 派给 PI。
|
||
- **禁止**：自动换模型、M3 关键角色、伪造 lease、递归把本修复任务再派给 PI worker、`pkill -f` 广谱杀进程。
|
||
- **MCP**：`.cursor/mcp.json` → `pi-subagents`（roles/run/result）；executor 来自 MCP 安装根。
|
||
- **Hook（advisory）**：`.cursor/hooks/guard-pi-dispatch.sh` / `guard-pi-shell.sh` 可在形状错误时 `ask`；**硬拒绝以执行器为准**，见规则 `cursor-hooks`。
|