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