diff --git a/.agent/rules/子代理交付.md b/.agent/rules/子代理交付.md new file mode 100644 index 0000000..2cdfe98 --- /dev/null +++ b/.agent/rules/子代理交付.md @@ -0,0 +1,10 @@ +# 子代理交付格式 + +> 触发：派发或承接任何子代理任务时生效。 +> 上位：[计划与提交](计划与提交.md) 的批次与验证分层；本文件只管子代理交付物的形状。 + +1. **三要素交付**：最终报告只含三节——做了什么（对象+动作）、验证方式与结果（命令+退出码，或检查名+通过与否）、阻塞项（无则整节省略）。总长不超过 20 行。 +2. **证据用指针**：diff、测试日志、指纹表不贴原文；引用文件路径与行号，验证产物落盘后只报路径。 +3. **不做总结性免责**：已验证事项直接陈述结论；未验证部分列入阻塞项，不写“不能据此宣称”“尚未证明”类空转声明。 +4. **进度汇报仅阻断级**：需要用户决策或无法继续时才联系主代理；例行进展不汇报，完成即按第 1 条交付。 +5. **最小必读**：主代理派发时列出本任务必读的 2~3 个文件；未列出的规则与 SoT 不预读、不加载。 diff --git a/.agent/rules/目录.md b/.agent/rules/目录.md index 5a2af7f..c9919cd 100644 --- a/.agent/rules/目录.md +++ b/.agent/rules/目录.md @@ -7,4 +7,5 @@ | 元数据消费 | [元数据消费.md](元数据消费.md) | 模具归元数据、实例归业务、只增不改、投影按用途的硬规则 | 实现或评审结构定义、扩展与投影时 | 与 S04 合同联动；未知字段不静默丢弃 | | 审校与修订 | [审校与修订.md](审校与修订.md) | 选区语义、不擅动正文形态、受控修订与派生失败可见 | 实现或评审修订、选段与章后处理时 | 与 B06 和正文结构合同联动 | | 文档与资源生成 | [文档与资源生成.md](文档与资源生成.md) | 生成物只由登记输入产生、索引一致、资源带发布身份 | 修改目录索引、登记资源或声明命令时 | 与 工具/维护索引.py 和 工具/构建资源包.py 联动 | -| 计划与提交 | [计划与提交.md](计划与提交.md) | 完整任务、能力依赖、并发分工、交付批次与独立整体审查 | 制定 plan、委派、集成与决定提交节奏时 | 先定边界和批次；获授权后一任务一提交，每批审查，最终验收不省略 | +| 计划与提交 | [计划与提交.md](计划与提交.md) | 完整任务、能力依赖、并发分工、交付批次、研发相位与分级整体审查 | 制定 plan、委派、集成与决定提交节奏时 | 先定边界和批次；获授权后一任务一提交，L3 批次独立审查，最终验收不省略 | +| 子代理交付 | [子代理交付.md](子代理交付.md) | 三要素交付、证据指针、仅阻断级汇报、最小必读 | 派发或承接任何子代理任务时 | 报告 ≤20 行；diff/日志/指纹表只给路径 | diff --git a/.agent/rules/计划与提交.md b/.agent/rules/计划与提交.md index 401e057..9635292 100644 --- a/.agent/rules/计划与提交.md +++ b/.agent/rules/计划与提交.md @@ -15,11 +15,22 @@ - **隔离与归属**：各线使用包含所需未提交改动的同一可核验基线，并发写入者使用隔离工作区；共享接口、迁移、装配和生成文件指定唯一维护者。不得擅自提交来制造基线，也不得从缺少当前改动的旧 HEAD 开工；无法安全隔离时说明具体限制，先推进不冲突工作。 - **集成有负责人**：委派给出输入、输出、文件边界和完成判据，主代理按依赖顺序承接差异与证据，验证实际消费者和跨任务链路。重测试按环境与预算容量限流，可变数据库、端口和会话相互隔离。 +## 研发相位（判据可判定） + +| 相位 | 进入判据 | 验证义务 | +|---|---|---| +| 开发期 | 任务尚未通过自身完成标准 | 只跑受影响快速检查或相关文件测试，及时修复失败 | +| 能力稳定 | 任务自身完成标准全绿（按 L 级证据口径） | 跑相应回归与真实接缝验证；替身与隔离遵守[测试隔离](测试隔离.md) | +| 批次稳定 | 批次内全部任务能力稳定 | 集中本批完整门禁与必要真实入口验证，再进入批次审查 | + +- 发现影响目标或授权的设计缺口时返回对应决策，不以临时替身掩盖，也不扩大无关任务；已有目标、方案和证据仍有效时直接承接。 +- **证据复用**：确认代码、合同、输入、环境、配置和工具版本仍适用后复用证据；出现相关变更、证据失效、新失败或未解决疑点时重验对应范围，影响不清时扩大到能覆盖风险的范围。 + ## 验证、提交与审查 -- **验证不过不收尾**：任务未通过与自身完成标准相称的验证时，继续实现并重验受影响部分；不以“基本完成”隐去失败或推给无关后续任务。分层验证与证据复用按执行流程执行。 +- **验证不过不收尾**：任务未通过与自身完成标准相称的验证时，继续实现并重验受影响部分；不以“基本完成”隐去失败或推给无关后续任务。分相位验证判据见上节；完成声称的证据分级（L1/L2/L3）与重任务判据以 [`../../../.agents/rules/verification-principles.md`](../../../.agents/rules/verification-principles.md) 为准。 - **一任务一提交**：获得明确提交授权后，每个完整任务验证通过即单独提交，只包含该任务产物；不把整个 plan 攒成一次大提交。未获授权时保留可审差异并说明未提交，不执行 `git add` 或 `git commit`，也不反复索取同一授权。提交不代表可合并或发布；合并、发布还须满足相应批次审查与集成验收，并另有明确授权。 -- **每批整体审查**：交付批次稳定并通过约定门禁后，起独立只读子代理审查本批全部真实改动，覆盖逻辑完整性、一致性、合理性、可行性，以及任务间链路、垃圾代码和被替代实现残留；通过前不得宣布该批完成。审查基线覆盖本批未提交与已提交改动，不能只看 HEAD 而漏掉工作树。 +- **整体审查按级触发**：L3 重任务批次（判据见 [`../../../.agents/rules/verification-principles.md`](../../../.agents/rules/verification-principles.md)——跨模块、超过 2 个文件、修改超 100 行、核心逻辑变动、不可逆操作，任一命中）稳定并通过约定门禁后，起独立只读子代理审查本批全部真实改动，覆盖逻辑完整性、一致性、合理性、可行性，以及任务间链路、垃圾代码和被替代实现残留；通过前不得宣布该批完成。审查基线覆盖本批未提交与已提交改动，不能只看 HEAD 而漏掉工作树。L1/L2 批次以门禁绿加抽查代替，不起独立审查、不重复审查。 - **审查不叠加**：不逐小任务、逐提交重复同一批次审查；已有审查覆盖的维度与有效证据直接承接，不因 Skill 名称不同再审一次。必要的高危方案事前评审不取消。发现问题后修复、验证，并对问题与受影响范围重审；影响扩大时同步扩大审查，不能以“一次”为由免除重审。 - **整体验收不省略**：多批计划最终核对批次间链路、未覆盖接缝、交付物与恢复条件；已有证据仍适用的部分复用，新增或受影响的集成行为必须验证，不能把各批通过简单相加当作整体验收。 - **集中收尾**：按批次同步权威记录和索引，清理本次替代内容，框架与创作内容分开审查、分开提交；按已交付能力、具体阻塞和剩余验收项汇报，不以测试或文档数量替代进度。 diff --git a/AGENTS.md b/AGENTS.md index 77c94c3..0e274ef 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -56,6 +56,7 @@ SoT 按主题分域，不做跨主题的全局排序。可执行脚本与书面 | 创作链条 | `muse/lifecycle/flow/chains/`（原路径 muse/lifecycle/flow/chains，已随旧实现退出，见固定基线） | scenario、purpose、功能 skill、角色槽位和保护节点的链路登记。 | | 红线约束 | [`.agent/约束/红线约束.md`](.agent/约束/作者主权.md) | 数据权威、探索边界、模型治理与代码提交的不可逾越红线。 | | 执行流程 | [`.agent/rules/执行流程.md`](.agent/rules/模块依赖.md) | 按条件适用的研发职责、分层验证与批次收尾；任务与依赖编排见[计划与提交](.agent/rules/计划与提交.md)。 | +| 子代理交付 | [`.agent/rules/子代理交付.md`](.agent/rules/子代理交付.md) | 派发子代理的交付物形状：三要素交付、证据指针、仅阻断级汇报、最小必读。 | | 审查标准 | [`.agent/规范/审查标准.md`](.agent/rules/文档与资源生成.md) | 智能体提示词 4 问、技能质量 7 问 + D8 复利审查规程与严重度定义。 | | 工程规范 | [`.agent/规范/`](.agent/规范/) | [`去AI味道工程规范.md`](.agent/rules/审校与修订.md)、[`指令集规范.md`](.agent/规范/命名.md)、[`术语规范.md`](.agent/规范/术语.md)。 | | 任务与沉淀 | [`docs/`](docs) | 单次任务探索、计划、评测资料与历史执行证据；稳定结论回填 SoT。 | @@ -69,7 +70,7 @@ SoT 按主题分域，不做跨主题的全局排序。可执行脚本与书面 3. **数据权威与先审后入**：数据库为唯一正式权威，严禁裸连操作；正文、规划与知识抽取默认生成 Shadow 候选，经用户明确确认后方可写入 Canonical 正典事实。 4. **模型治理与受控探索**：模型调用严格遵守 5 小时额度窗口与受控治理链，角色严格锁定[角色合同](.agent/角色/角色合同.md)指定模型（写手/规划固定顶级推理模型，裁判使用独立精确白名单）；确定性逻辑、门禁与报告组装由脚本完成，严禁调用模型；智能体探索仅限圈定只读工具并留痕。 5. **会话交互与汇报纪律**：全程使用简体中文白话，坚决去除 AI 味（直陈事实、动作与后果，禁止清嗓子套话与空转缓冲词）；需要用户决策时，必须交代清楚前因后果及各选项对下游的影响。 -6. **提交授权与形而上审查**：严禁未经用户明确授权执行 `git add` 或 `git commit`；按[计划与提交](.agent/rules/计划与提交.md)预先确定交付批次，每批门禁通过后由独立只读子代理完成四维整体审查，通过前不得宣布该批完成；不逐笔提交叠加审查，必要的事前方案评审、修复重审和最终集成验收仍保留；框架与创作内容分开审查、分开提交。 +6. **提交授权与形而上审查**：严禁未经用户明确授权执行 `git add` 或 `git commit`；按[计划与提交](.agent/rules/计划与提交.md)预先确定交付批次，L3 重任务批次（判据见 `../.agents/rules/verification-principles.md`：跨模块、超过 2 个文件、修改超 100 行、核心逻辑变动、不可逆操作，任一命中）门禁通过后由独立只读子代理完成四维整体审查，通过前不得宣布该批完成，L1/L2 批次以门禁绿加抽查代替；不逐笔提交叠加审查，必要的事前方案评审、修复重审和最终集成验收仍保留；框架与创作内容分开审查、分开提交。 7. **计划边界与提交节奏**：以可独立验收的完整结果拆任务，明确边界、依赖、维护者与验证方式；前置满足且有收益的独立任务分工并发，依赖任务按已验证能力衔接；验证不过不收尾，获授权后每个完整任务单独提交。具体编排、隔离和批次收尾以[计划与提交](.agent/rules/计划与提交.md)为准。 ---