4.0 KiB
4.0 KiB
阶段 C：角色合同与领域文档对齐目标形态
日期：2026-08-22 总 plan：2026-08-22-agent-example整体收敛总plan.md 状态：已完成（本文件同时是阶段 C 台账与验证记录）。
1. 意图
按边界合同重写五个角色的角色合同、创作流程领域、智能体领域与主链导读，明确主代理职责（润色与授权协调）、智能体自主探索、补证/重写由人管控。
2. 边界
- 只改文档与角色提示，不改任何代码。
- 只写目标合同与代码当前事实，不写待办措辞（导读中"当前实现"标注沿用该文档既有惯例）。
- 不动错位清单中归属代码阶段的项目（#1、#2、#5、#6）。
3. 错位清单处置
| # | 项目 | 本阶段处置 |
|---|---|---|
| #3 | 写手探索限制以提示词层合同表达 | 已处置：角色合同 writer 节改为"经授权只读技能自主探索 + 依赖清单"；工具落地归阶段 D |
| #4 | 模型策略合同文档与代码双源 | 文档侧已处置：角色合同声明"本文件是模型策略事实源，执行侧常量是镜像，不一致即缺陷"，07 领域同步；代码侧合并归阶段 F |
| #7 | 评委角色文件声明工具与实际不符 | 已处置：角色合同与角色文件明确评委为圈定授权（实验场景最窄 / 生产预检放宽 + 禁看清单），与实际白名单机制一致 |
4. 文件台账
| 处置 | 文件 | 原因 |
|---|---|---|
| 修改 | .agent/docs/architecture/角色合同.md |
五个角色合同按目标形态重写：探索与取材/取证节、依赖清单要求、评委圈定授权与禁看清单；头部改为引用边界合同，声明模型策略事实源地位 |
| 修改 | .agent/docs/architecture/domains/07-Agent与Skill领域.md |
§1 引边界合同；§2 四类执行单元改为五组件（主代理/创作智能体/工具 server/脚本与静态校验），派发合同六条（含会话复用与依赖清单）；§5 改为目标工作链与授权管控（无业务次数硬上限）；§7 运行底座改为三条链分工 |
| 修改 | .agent/docs/architecture/domains/05-创作流程领域.md |
§5 改为目标工作链与编排合同（主代理职责、授权终态、防造假校验），保护步骤 6 条保留；当前实现事实单列；§6 补证口径改为"技术保护上限，业务授权归人" |
| 修改 | .agent/docs/architecture/创作周期与Skill导读.md |
角色定位改主代理职责；五角色说明补"都是创作智能体、圈定授权例外"；节点 W 主链图改目标形态并标注当前实现；合同索引加边界合同行 |
| 修改 | .agent/agents/writer.md |
加探索方法（细纲→人物→前文→世界规则→依赖清单）；工具提示改"探索只读" |
| 修改 | .agent/agents/detector.md |
加取证方法（对照细纲→检索正典→回读知情范围→查规则→引文回指） |
| 修改 | .agent/agents/planner.md |
加探索方法（上层规划→既有设定→承接点→依赖清单） |
| 修改 | .agent/agents/extractor.md |
加探索方法（回读正文→查既有卡→低置信标注） |
| 修改 | .agent/agents/judge.md |
加授权与取证节：圈定授权两场景 + 禁看清单（候选身份、oracle、他评结果） |
| 保留 | 派发装配合同与测试断言 | 系统提示词四段结构（身份+合同+Schema+冻结输入）不变，测试全绿 |
| 遗留 | 错位 #4 代码侧（muse_role 常量与合同统一） | 归阶段 F 直调链终态处置 |
| 遗留 | 生产链预组装上下文与目标探索形态的差异 | 归阶段 E 切换 |
5. 验证
- 派发装配测试（系统提示词四段结构、合同哈希、角色合同装载）：20 项通过。
- 细纲合同测试（planner.md 含 fine_outline）：6 项通过。
- 角色目录登记与合同装载测试：7 项通过。
- 角色目录校验：5 个角色、58 个 Skill 一致。
- 技能严格审计：58 个 Skill，阻断 0，质量发现 0。
- Skill 索引一致性：通过。