Route project work through configured agents
Why: replace fixed Cursor execution authority with project-configured agent routing Evidence: focused task-card contract, agent-exec validation, governance regression, and diff check Impact: updates project policy, task templates, capability records, and current task metadata Refs: U4; docs/superpowers/plans/2026-10-15-project-agent-execution.md
This commit is contained in:
+2
-1
@@ -18,7 +18,8 @@
|
||||
| standards/verification.md | 验收 | 本地 make test-governance + 组合测试；当前证据与历史 scratch 记录分开 |
|
||||
| standards/multi-repo.md | 跨仓/gitlink | manual；受控历史迁移通道已于 2026-09-30 行使一次（documents/records/2026-09-30-history-migration.md） |
|
||||
| 工作区回收 | 交付终点 | advisory（task-finish）；负例：合入前 finish 拒绝输出 |
|
||||
| policy/delivery.md（项目收紧） | 需求、长期方向、试验、实施迭代及交付 | goal-first：目标/范围/终点一次确认，范围内连续推进验证、Review、合入和安全收口；实施写入按 cursor-per-unit（一单元一新 Cursor CLI；主模型不直接写实施变更；不可用则记 blocker）；仅真实决策点需人工；任务卡提供记录，post-merge 默认只提示，行为回归见 tests/test_task.py |
|
||||
| policy/delivery.md（项目收紧） | 需求、长期方向、试验、实施迭代及交付 | goal-first：目标/范围/终点一次确认，范围内连续推进验证、Review、合入和安全收口；实施写入按 agent-per-unit（配置 AGENT-EXECUTION.md；外部 Agent 一单元一新进程；host 仅在有效 host-fallback-authorized 收据后可写实施变更）；仅真实决策点需人工；任务卡提供记录，post-merge 默认只提示，行为回归见 tests/test_task.py |
|
||||
| AGENT-EXECUTION.md + agent-exec | 项目执行路由 | 本地 SELF：parser/adapter/controller 假 CLI 契约由 tests/test_agent_exec*.py 与 make agent-exec-validate 强制；已安装 provider/model 真实身份待 U5 探针，此前不接受为已就位；远端平台准入仍为 GATE |
|
||||
| standards/tool-adaptation.md（draft.8） | 为工具创建规则/钩子实例 | 本组合 CLI/git 级实例已登记：policy/tool-adaptation-matrix.md（A1–A7 逐行定级+正负例证据） |
|
||||
| 同上（zcode 实例） | zcode 客户端写路径 | policy/tool-adaptation-zcode.md：PreToolUse 写守卫；脚本负例与客户端接线分开，客户端 pending-live |
|
||||
| core/baseline.md「规范层级」+ documentation.md「记忆分层/机制化」（draft.9） | 层级效力、记忆权威、经验机制化 | manual：本仓 policy/ 仅收紧不放宽；记忆四层按条文执行（任务卡=任务记忆，documents/records=项目记忆，Dev 仓 AGENTS.md 指针已就位） |
|
||||
|
||||
+19
-12
@@ -28,22 +28,29 @@
|
||||
需求拆解、评估、方案和计划可以共用一份任务卡。小任务只记录目标、范围、验收、关键决定和验证；
|
||||
不适用的阶段标记原因后直接跳过。任务启动检查、独立工作区和收据用于准备现场，不表示业务结果已验证。
|
||||
|
||||
## Cursor 实施单元与主模型职责
|
||||
## Agent 实施单元与主模型职责
|
||||
|
||||
产生仓库变更的实施工作拆成可独立实施的单元。任务卡默认记 `实施执行：cursor-per-unit`：
|
||||
**每个实施单元对应一次全新的 Cursor CLI 进程/运行**；不得复用已有 Cursor 进程处理另一单元。
|
||||
产生仓库变更的实施工作拆成可独立实施的单元。任务卡默认记
|
||||
`实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）`。执行路由以根目录
|
||||
[AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 为唯一权威；按角色声明的候选顺序在新进程与
|
||||
隔离工作区中尝试外部 Agent。不得跨单元复用同一外部进程。
|
||||
|
||||
主模型（host）负责计划、拆解、调度、强制范围、检查与审阅 diff、运行权威验证、集成与提交、
|
||||
管理 PR/CI/合入、写入证据与任务管理元数据，以及安全清理。主模型**不得直接撰写实施变更**。
|
||||
权威验证、集成、合入与任务卡证据所有权属于 host；worker 的局部自检不能替代任务卡证据、
|
||||
独立 Review、当前 HEAD 的 CI 与平台准入。
|
||||
主模型（host）负责计划、拆解、有界单元包、强制范围、检查与审阅实际 diff、运行权威验证、
|
||||
规范提交、管理 PR/CI/合入、写入证据与任务管理元数据，以及安全清理。权威验证、集成、合入与
|
||||
任务卡证据所有权属于 host；worker 的局部自检不能替代任务卡证据、独立 Review、当前 HEAD 的 CI
|
||||
与平台准入。
|
||||
|
||||
每个 Cursor worker 只接收一个有界单元。Worker 不得扩围、提交、推送、打开或合并 PR、
|
||||
派遣同伴、改变路由或模型、部署，或清理 worktree。
|
||||
每个外部 worker 只接收一个有界单元。Worker 不得扩围、提交、推送、打开或合并 PR、派遣同伴、
|
||||
改变路由或模型、部署，或清理规范 worktree。
|
||||
|
||||
若 Cursor CLI 不可用或无法完成该单元，停止该单元，并在任务卡「Cursor 实施收据」记录 blocker；
|
||||
不得静默把实施交回主模型代写。规划、只读调查、证据捕获、控制器/任务卡元数据与集成操作
|
||||
属于 host 管理工作，不递归创建另一 Cursor 实施单元。
|
||||
`run-everything` 仅在隔离单元内取消逐步命令批准提示；不扩大用户授权范围，也不授予 worker
|
||||
规范 Git、推送、PR、合入、部署或清理权威。
|
||||
|
||||
当前 host **仅当** `scripts/agent_exec.py run` 对该精确单元发出有效
|
||||
`host-fallback-authorized` 收据后，方可直接撰写该单元的仓库变更。全部候选须已安全耗尽
|
||||
（`unavailable` 或已精确恢复的 `failed-clean`）。`failed-unknown`、`scope-expansion`、无效配置、
|
||||
未对账 Git 状态与安全失败均不授权回退。规划、只读调查、证据捕获、控制器/任务卡元数据与集成
|
||||
操作属于 host 管理工作，不递归创建另一实施单元。
|
||||
|
||||
本条不重新引入逐阶段人工门禁；goal-first 的决策点、严格范围、先可用再迭代、独立 Review、
|
||||
证据、平台准入与高后果双钥匙规则继续有效。
|
||||
|
||||
+16
-4
@@ -3,10 +3,22 @@
|
||||
本文件细化根 AGENTS.md 的启动、验证和回收规则。通用语义以固定的
|
||||
`deps/development-guidelines` 为准；门禁实现及回归用例随本仓版本管理。
|
||||
需求表、设计试验、迭代调整、阶段产物、人工决策及智能体 Review/合入按
|
||||
[迭代交付](delivery.md) 执行。任务卡分别记录授权边界、必要人工决策点、`cursor-per-unit` 实施执行模式、
|
||||
逐单元 Cursor 实施收据、智能体审阅者及对象版本；权威验证与合入仍由 host/主模型执行，
|
||||
Cursor worker 局部自检不替代。本地 evidence 仅记录 SELF 命令，不能证明授权/人工决策或提升为
|
||||
CI/独立审阅证据。
|
||||
[迭代交付](delivery.md) 执行。任务卡分别记录授权边界、必要人工决策点、
|
||||
`agent-per-unit（配置：AGENT-EXECUTION.md）` 实施执行模式、逐单元 Agent 实施收据、
|
||||
智能体审阅者及对象版本；权威验证与合入仍由 host/主模型执行，worker 局部自检不替代。
|
||||
本地 evidence 仅记录 SELF 命令，不能证明授权/人工决策或提升为 CI/独立审阅证据。
|
||||
|
||||
### Agent 实施收据与回退
|
||||
|
||||
每次外部实施尝试须在任务卡「Agent 实施收据」记录：配置摘要（`AGENT-EXECUTION.md` digest）、
|
||||
角色、声明候选顺序、attempt、CLI/模型、终态、transport、fallback，以及源码外原始收据路径。
|
||||
初始生成状态为 `NOT_RUN`。原始事件流与超限输出保留在源码外；未知终态（`failed-unknown`）
|
||||
与 `scope-expansion` 的隔离工作区须保留待对账，不得静默丢弃。清理须有精确恢复或保留现场的
|
||||
可复核证据。
|
||||
|
||||
当前 host 仅在 `scripts/agent_exec.py run` 对该精确单元发出有效 `host-fallback-authorized`
|
||||
收据后，方可撰写该单元的仓库变更；该收据不得由叙述或局部失败推断。`failed-unknown`、
|
||||
`scope-expansion`、无效配置、未对账 Git 状态与安全失败均不授权回退。
|
||||
|
||||
## 启动与恢复
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
| A5 回收 | 本地命令检查；写者退出须可证明，无法证明时才请求 owner 决策 | 登记根目录、锁/操作状态、父子仓与唯一文件、合入核验 | `tests/test_task.py` |
|
||||
| A6 秘密 | 本地脱敏及 CI 获取边界；权限与宿主隔离另验 | 命令/输出/摘要脱敏，凭据不持久写 Git 配置 | `tests/test_evidence.py`、`tests/test_ci_credentials.py` |
|
||||
| A7 证据 | 本地 SELF 收据；外部来源独立核验 | 首次捕获、完整脱敏输出/摘要、对象记录、原样导入 | `tests/test_evidence.py`；CI/审阅链接另核 |
|
||||
| A8 阶段记录与迭代 | goal-first + cursor-per-unit；模板默认连续执行，仅真实决策点需人工，没有全流程授权强制；实施写入经新 Cursor 进程按单元执行 | policy/delivery.md；任务卡分别记录阶段状态、决策点、Cursor 实施收据、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | `tests/test_task.py` 核对 goal-first/cursor-per-unit 模板及钩子不自动写入；智能体核对授权范围、实施单元边界、Review、冲突及匹配 HEAD 的 CI/平台准入 |
|
||||
| A8 阶段记录与迭代 | goal-first + agent-per-unit（AGENT-EXECUTION.md）；模板默认连续执行，仅真实决策点需人工，没有全流程授权强制；实施写入经配置候选在新进程/隔离工作区按单元执行；host 回退仅凭有效 host-fallback-authorized 收据 | policy/delivery.md、AGENT-EXECUTION.md；任务卡分别记录阶段状态、决策点、Agent 实施收据（配置摘要/角色/候选/attempt/CLI-模型/终态/transport/fallback/源码外路径）、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | `tests/test_task.py` 核对 goal-first/agent-per-unit 模板及钩子不自动写入；`python3 scripts/agent_exec.py validate` / parser·adapter·controller 假测为本地 SELF 强制行为；已安装 provider/model 身份待 U5，远端平台准入为 GATE；智能体核对授权范围、实施单元边界、Review、冲突及匹配 HEAD 的 CI/平台准入 |
|
||||
| A9 长期方向与后续任务 | manual；模板不校验规划有效性或自动调度任务 | policy/delivery.md；PROJECT.md 提供规划入口，任务卡关联规划/里程碑并记录下一步建议 | `tests/test_task.py` 核对生成字段与未授权默认值；智能体核对当前规划、进展、重复任务和建议依据，新任务仍不自动获得授权 |
|
||||
| A10 交付窗口 | manual；无自动互斥或接管 | [合入调度](merge-queue.md)与 #518：同一目标一个最终窗口，等待分支不追 main；轮到后同步、固定、验证并由智能体合入 | 每个实际 PR 核对窗口记录、精确 HEAD 三项 GATE、Review 和合入后 main；不要求额外试行或全写者审计 |
|
||||
| A11 固定后证据 | manual 选择源码外位置；工具捕获绝对未用路径/原始输出；无 OS 冻结 | policy/governance.md；RECEIPT 捕获，后续授权闭合再原样导入 | `tests/test_evidence.py` 固定对象、权限、覆盖拒绝、原样导入与幂等 |
|
||||
|
||||
Reference in New Issue
Block a user