diff --git a/AGENTS.md b/AGENTS.md index 135cb5e3..322dab9c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,6 +9,21 @@ PR 合入及安全收口由智能体连续推进。只在目标/范围/验收条 当前 HEAD 的 CI 通过后执行合入,无需另请人工操作。具体决策点、版本及授权条件见 policy/delivery.md。 +## 立即生效的最高优先级(强制) + +- 在既有授权与强制安全边界内,**先交付用户明确要求的产物**。不得用基础设施、工具治理、 + 通用化、加固、重构或“以后可能用到”替代当前目标;尤其禁止把简单 Markdown、配置或说明 + 修改擅自升级成平台、框架、自动化系统或大规模工程。 +- 采用最小充分实现:先让目标可用、系统可用并通过最小直接验证,然后立即停止并交付;体验、 + 结构、性能与治理完善必须作为后续独立增量,不得拖延当前结果。 +- 只修复直接阻塞目标、可用性、明确验收条件或强制安全门禁的问题。高价值非阻塞项只简记, + 低影响噪音直接忽略;Review/迭代循环只围绕阻塞项,阻塞项闭合即结束。 +- 测试与风险成比例:实施中只跑最小直接检查;完整/长耗时套件仅在最终候选、规范明确要求或 + 实际影响面确有必要时运行一次。禁止在每个小文档、配置或 adapter 修改后重复全量测试。 +- 编排成本不得超过任务本身。平凡文档/配置单元最多使用一个有界 CLI 进程;除非用户明确要求 + 或已有证据证明是当前目标的直接阻塞,否则不得新增嵌套控制器、额外 worktree、复杂收据体系 + 或新架构。执行路由是手段,不能成为推迟用户产物的理由。 + ## 任务目标与范围(强制) - 执行优先级固定为:授权与安全边界 → 本次任务目标和系统可用 → 阻塞目标的必要问题 → diff --git a/policy/delivery.md b/policy/delivery.md index baac07e2..3a135ac4 100644 --- a/policy/delivery.md +++ b/policy/delivery.md @@ -7,6 +7,42 @@ 本文件是阶段、决策点与连续执行的权威表述;启动、同步、命令证据和回收操作见 [开发门禁](governance.md)。规则的执行能力见 [能力矩阵](tool-adaptation-matrix.md)。 +## 最高优先级:目标兑现与最小充分交付 + +本节自写入起立即生效,并在不削弱既有授权、证据、Review、CI、合入、清理与高后果双钥匙 +边界的前提下,优先于本文件其他关于阶段、编排和完善程度的解释。 + +### 先做用户要求,不把任务升级成工程项目 + +- 用户明确要求的产物、范围、验收条件和交付终点是当前工作的唯一主线。基础设施、工具修复、 + 通用化、加固、重构、迁移和新架构只有在用户明确要求,或有可复核证据证明其直接阻塞当前 + 目标时才能进入当前范围。 +- Markdown、配置、提示词、链接和说明等简单修改默认走最小闭环:定位 → 修改 → 最小直接验证 + → 报告。不得为此新建平台、框架、自动化系统、嵌套控制器、额外 worktree、复杂收据体系、 + 新 PR 模板或新的阶段审批。 +- Agent 路由、任务卡和证据工具都是交付手段,不是交付目标。候选 CLI 迟迟不产出时按配置及时 + 切换或按既有回退规则处理;不得转而长期建设或加固路由系统,导致用户要求的简单产物一直未交付。 + +### 最小可用即停,问题按是否阻塞分流 + +- 首次达到“用户要求的产物可用、受影响系统可用、最小直接验证通过”后,立即停止新增工作并 + 进入交付。后续体验、结构、性能、命名、治理与文档完善是新的增量,须由用户明确要求或另行授权。 +- 只修复直接导致目标无法实现、系统不可用、明确验收失败或强制安全门禁失败的问题。高价值但 + 不阻塞的问题只记录事实、影响与建议归属;低影响噪音直接忽略,不创建任务、不阻塞交付。 +- Review 和 CLI 迭代只处理阻塞项。阻塞项闭合、请求产物可用且最小验证通过后循环立即结束; + 不得以“更完整”“更安全但并非门禁”“更通用”或“顺手清理”为由继续循环。 + +### 验证与编排必须成比例 + +- 实施阶段运行能直接证明本次修改的最小检查。完整或长耗时测试只在最终候选上运行一次,且仅限 + 本仓规范明确要求、真实影响面覆盖广,或最小测试不足以判断回归的情况。 +- 禁止在每个小文档、配置、提示词或 adapter 修改后重复完整套件;已经针对同一候选取得且对象 + 未变化的有效结果不得因记录、格式或非阻塞意见重复执行。 +- 编排成本不得超过任务本身。平凡单元最多启动一个有界 CLI 进程;主模型负责计划、范围与审查, + 但角色分工不得推迟简单产物。检测到实现粒度与任务不匹配时,立即降级到最小充分做法。 +- 移除机械人工停顿不等于增加机械 Agent 停顿。真实业务取舍、授权变化、高后果操作和必须由用户 + 判定的验收仍请求人工;除此之外,不为计划、工具、自审或非阻塞完善反复等待。 + ## 授权、决策点与连续执行 任务卡默认记为 `goal-first`。用户的直接请求在目标、允许动作、写入对象和交付终点足够明确时,