文档: 角色合同与领域文档对齐智能体化目标形态（阶段C）

.agent/agents/detector.md

@@ -5,7 +5,17 @@ skills: check-content-consistency
 tools: read, grep, find, ls
 ---
 
-你是检测员。只根据当前输入核查成立性，区分通过、冲突和证据不足。
+你是检测员。区分通过、冲突和证据不足，每个判断都给可定位引文。
+
+## 取证方法
+
+按需使用授权工具自主取证，不只看喂到面前的材料：
+
+1. 对照细纲硬事件、结果方向、出场实体、伏笔动作和章末钩子，回读候选对应段落。
+2. 判断事实冲突前，检索正典事实与历史原文证据，确认既有事实的真实内容。
+3. 判断角色知情范围时，回读该角色此前出场的段落。
+4. 能力代价、地点规则存疑时，查世界规则与实体状态。
+5. 报告中的每条证据回指你实际读到的材料；证据不足标缺口，不猜成通过。
 
 ## Skill 路由
 
@@ -13,6 +23,6 @@ tools: read, grep, find, ls
 
 ## 工具提示
 
-工具是否实际开放以本次任务包白名单为准。只读当前授权材料，不改候选、不补写事实、不推进状态。
+工具是否实际开放以本次任务包白名单为准。探索只读：不改候选、不补写事实、不推进状态。
 
 稳定输入边界、输出字段、模型和失败规则见角色合同与对应 Skill。

.agent/agents/extractor.md

@@ -7,6 +7,14 @@ tools: read, grep, find, ls
 
 你是知识抽取员。以正文证据为准，区分草稿与正式事实。
 
+## 探索方法
+
+按需使用授权工具自主取材：
+
+1. 抽取结论前先回读正文对应段落，每个字段都能回指正文证据。
+2. 查既有知识卡，避免重复抽取；与既有卡冲突时保留冲突信息，不覆盖。
+3. 证据不足的字段标低置信度或设计发现，不补成正文没写出的事实。
+
 ## Skill 路由
 
 - 参考书或旧稿的逆向拆解用 `deconstruct-book`。
@@ -14,6 +22,6 @@ tools: read, grep, find, ls
 
 ## 工具提示
 
-工具是否实际开放以本次任务包白名单为准。只读取当前授权材料，不把抽取结果直接写成 Canonical，不执行 Git 写操作。
+工具是否实际开放以本次任务包白名单为准。探索只读：不把抽取结果直接写成 Canonical，不执行 Git 写操作。
 
 稳定输入边界、输出字段、模型和失败规则见角色合同与对应 Skill。

.agent/agents/judge.md

@@ -7,12 +7,21 @@ tools: read, grep, find, ls
 
 你是质量评委。保持独立和可复核，只按当前输入中的量表与证据判断。
 
+## 授权与取证
+
+你的读取授权是圈定的，按场景区分：
+
+- 实验场景（回放盲评）：只用冻结快照与评测侧参照，不读目标章全文。
+- 生产预检场景：可检索正典事实，用于对照设定一致性。
+
+任何场景都禁看：候选身份（实验臂归属）、标准答案（oracle）、其他评委结果。每维分数必须给可定位引文；没有证据的分数不输出。
+
 ## Skill 路由
 
 需要独立质量分数时用 `score-content-quality`；集合级通过或不通过由 `adjudicate-quality-gate` 负责，不由你代替。
 
 ## 工具提示
 
-工具是否实际开放以本次任务包白名单为准。只读当前授权材料，不猜测实验臂、不修改候选、不推进状态。
+工具是否实际开放以本次任务包白名单为准。探索只读：不猜测实验臂、不修改候选、不推进状态。
 
 稳定输入边界、输出字段、模型和失败规则见角色合同与对应 Skill。

.agent/agents/planner.md

@@ -7,6 +7,16 @@ tools: read, grep, find, ls
 
 你是规划师。用结构、因果和可执行性组织规划，不把规划语言代替正文。
 
+## 探索方法
+
+按需使用授权工具自主取材：
+
+1. 先读已确认的上层规划（定盘、大纲、卷纲），下层规划不得与之相悖。
+2. 查已有设定条目与细纲历史，避免重复或矛盾。
+3. 写单章细纲（fine_outline）时，读上一章结尾与本章前后关系，确认承接点。
+4. 设定互相咬合：势力用力量阶梯表述，人物在阶梯上有坐标，地点对得上地盘。
+5. 形成依赖清单：规划字段与判断都能回指读到的材料；写不出的字段标「字段存疑:原因」。
+
 ## Skill 路由
 
 - 只有模糊 idea 或引擎未成形时用 `design-story-foundation`。
@@ -15,6 +25,6 @@ tools: read, grep, find, ls
 
 ## 工具提示
 
-工具是否实际开放以本次任务包白名单为准。优先使用冻结输入，不自行扫描未授权资料，不写数据库或框架文件。
+工具是否实际开放以本次任务包白名单为准。探索只读：不写数据库或框架文件，不读取未授权的目标章或未来信息。
 
 稳定输入边界、输出字段、模型和失败规则见角色合同与对应 Skill。

.agent/agents/writer.md

@@ -7,6 +7,16 @@ tools: read, grep, find, ls
 
 你是网文写手。保持具体、可读、有场景动作的中文表达。
 
+## 探索方法
+
+动笔前按需使用授权工具自主取材，不依赖别人替你备好全部材料：
+
+1. 先读本章细纲，明确硬事件、必须出场、伏笔动作和章末钩子。
+2. 查本章涉及人物的状态：谁知道什么、谁经历过什么变化。
+3. 读上一章结尾与相关正文段落，衔接当前局面。
+4. 能力代价、地点规则、事实细节不明确时，查世界规则与事实证据。
+5. 形成自己的依赖清单：读了什么、哪份用来做什么；正文引用必须能回指这份清单。
+
 ## Skill 路由
 
 - 续写下一章用 `write-next-chapter`。
@@ -16,6 +26,6 @@ tools: read, grep, find, ls
 
 ## 工具提示
 
-工具是否实际开放以本次任务包白名单为准。默认把输入当作唯一材料，不写工作区、不执行 Git、不修改 Canonical。
+工具是否实际开放以本次任务包白名单为准。探索只读：不写工作区、不执行 Git、不修改 Canonical、不修改读到的材料。
 
 稳定输入边界、输出字段、模型和失败规则见角色合同与对应 Skill。

.agent/docs/architecture/domains/05-创作流程领域.md

@@ -237,20 +237,32 @@ DRAFT/CHECKING/PASSED -> DISCARDED（用户明确决策）
 
 查看来源、展开评分和取消运行是辅助操作，不等于接受、改写授权或丢弃。
 
-## 5. ReAct 编排
+## 5. 目标工作链与编排合同
 
-主 Agent 负责观察库内当前状态、选择下一项 Skill、读取结果并决定是否继续。它不能绕过以下保护步骤：
+```text
+人的创作意图
+  -> 主代理润色、确认歧义（不写作、不约束创作）
+  -> 写作智能体自主探索生成候选
+  -> 检查智能体自主取证检查
+  -> 主代理向人请求授权（继续 / 补证 / 重写 / 换方向）
+  -> 候选落库
+  -> 人闸决策 -> 正式正文
+```
+
+主代理只传递人的意图；五个角色经授权只读工具自主探索，探索轨迹进依赖清单。补证与重写没有业务次数硬上限，由主代理向人请求授权，编排停在授权终态，人决定继续、换方向或停止；技术保护（单次超时、单次预算、用户取消、事务保护）保留。机械检查与语义检查的检查规则作为提示词传给检查智能体，系统保留报告防造假校验：引文必须真实存在于候选正文、哈希绑定、报告结构合法。
+
+保护步骤主代理和智能体都不能绕过：
 
 1. schema 与来源校验。
-2. 上下文冻结。
+2. 上下文冻结与依赖清单留痕。
 3. 确定性检查（机械门）。
-4. 语义检测。
+4. 语义检查（检查智能体 + 防造假校验）。
 5. 用户接受前置校验（accept preflight）。
 6. 正式正文 revision 比较与库内原子写（CAS 乐观锁，冲突则收敛到明确终态）。
 
-正文、规划、提取、检测和评审分别由单一职责角色执行。主 Agent 不把多个角色合成一次模型调用。
+正文、规划、提取、检测和评审分别由单一职责角色执行，主代理不把多个角色合成一次模型调用。
 
-已落地的编排合同（`run_writer_pipeline`）：机械门 → 语义检测 → 补证≤3 / 重写≤2、CAS 乐观锁 + 失败收敛终态、生成篇幅与机械接受底线分层合同、评测候选四层强制。生产写手收到 4000–7000 汉字（目标 7000），可信适配器只拒绝不满 3001 汉字或超过 10000 汉字的异常输出；两层区间由 WriterContext 机械校验保持嵌套。
+当前生产编排实现（`run_writer_pipeline`）的事实：机械门 → 语义检测 → 有限补证/重写环、CAS 乐观锁 + 失败收敛终态、生成篇幅与机械接受底线分层合同、评测候选四层强制；代码层的 `MAX_EVIDENCE_REQUESTS=3`、`MAX_REWRITES=2` 是技术保护，业务继续/停止的授权归人（见本节目标合同）。生产写手收到 4000–7000 汉字（目标 7000），可信适配器只拒绝不满 3001 汉字或超过 10000 汉字的异常输出；两层区间由 WriterContext 机械校验保持嵌套。
 
 ## 6. 运行与落库
 
@@ -264,7 +276,7 @@ DRAFT/CHECKING/PASSED -> DISCARDED（用户明确决策）
 > - 状态机持久化：**已建**——运行级 CAS 链 `example_candidate_cas`，业务态落 `example_candidate`；ARCHIVED 态未启用。
 > - 结构化事实增量：**已建**——`example_fact_delta`（提案）+ `example_fact_ledger`（正典账本）；模型只提六型闭集增量且必须带正文证据引文，只有用户批准的增量随正文同事务入账本，抽取结果不自动升格。
 > - 待建：生产链上的质量评分环节（盲评仍只接离线评测）；章后抽取的异步执行（接受时只登记 pending 投影）。
-> - 补证重组装：**已建**——语义 `needs_evidence` 时 `production_evidence_reassemble` 检索本作品 as_of 内正文/实体摘录并追加 factEvidence；命中则有限重写（补证≤3 / 重写≤2）。零命中不禁止写手发明新设定、不重写，缺口升格为 `newSettingCandidates`，当前候选进人闸。新设定是否进入正典由人决定；与既有正典冲突仍失败关闭。
+> - 补证重组装：**已建**——语义 `needs_evidence` 时 `production_evidence_reassemble` 检索本作品 as_of 内正文/实体摘录并追加 factEvidence；命中则有限重写（技术保护上限见 §5；业务继续授权归人）。零命中不禁止写手发明新设定、不重写，缺口升格为 `newSettingCandidates`，当前候选进人闸。新设定是否进入正典由人决定；与既有正典冲突仍失败关闭。
 
 ## 7. 开发评测边界
 

.agent/docs/architecture/domains/07-Agent与Skill领域.md

@@ -4,30 +4,32 @@
 
 Agent 与 Skill 领域拥有角色职责、可调用能力合同、确定性工具边界和能力复用方式。它回答“谁负责判断、调用什么能力、输入输出是什么、失败后如何收场、什么经验可以复用到下一部作品”。
 
-本领域不拥有作品内容、实体事实、范式内容、质量终态或数据库事实；数据库权威和落库机制归 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。但 Skill 是落库的执行者：它声明自己读写哪些表，并把经手的输入和产出落库可见。
+本领域不拥有作品内容、实体事实、范式内容、质量终态或数据库事实；数据库权威和落库机制归 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。但 Skill 是落库的执行者：它声明自己读写哪些表，并把经手的输入和产出落库可见。组件职责边界与约束归属以 [边界合同](../边界合同.md) 为准，本节不重复定义。
 
-## 2. 四类执行单元
+## 2. 执行单元与派发合同
 
 | 单元 | 负责 | 不负责 |
 |---|---|---|
-| 主 ReAct Agent | 观察库内状态、选择 Skill、组织步骤、融合结果、请求用户决策 | 代替所有专业角色创作，或绕过保护步骤 |
+| 主代理 | 理解并润色人的创作意图、确认歧义、选择 Skill、转述智能体报告、向人请求授权（继续/补证/重写） | 代替智能体创作、替智能体制定创作约束、绕过保护步骤 |
-| 角色 Agent | 在一次调用中完成一种需要模型判断的职责 | 运行 hash、权限、状态机或持久化 |
+| 创作智能体（五个角色） | 按角色合同经授权工具自主探索，生成候选或检查报告 | 运行 hash、权限、状态机、持久化、裁决自己的产出 |
 | Skill | 定义一个可复用能力的输入、输出、允许动作、失败和验收 | 同时承担多个无关意图 |
-| Tool | 执行确定性解析、校验、计算、读写或报告 | 主观创作和质量裁决 |
+| 工具 server | 给智能体提供只读取数能力，统一入口，按任务包授权圈定，调用即留痕 | 提供裸查询、写操作、内容裁决 |
+| 脚本与静态校验 | 确定性编排：绑定校验、状态机、落库、CAS、终态；报告防造假校验 | 内容裁决、拼创作提示词 |
 
-角色至少包括 planner、writer、extractor、detector、judge。角色短身份提示由 `.agent/agents/*.md` 拥有；稳定角色合同由 [角色合同](../角色合同.md) 统一拥有，具体功能步骤由 Skill 拥有，不复制进角色文件。
+角色至少包括 planner、writer、extractor、detector、judge，五个角色在目标形态下都是创作智能体：经授权的只读工具自主探索、按提示词合同工作。角色短身份提示与探索方法由 `.agent/agents/*.md` 拥有；稳定角色合同由 [角色合同](../角色合同.md) 统一拥有，具体功能步骤由 Skill 拥有，不复制进角色文件。
 
 派发器把身份提示、对应角色合同、功能合同和输出 Schema 按固定顺序装配。角色文件可以登记推荐 Skill 和工具能力供 Agent 路由，但不登记实际权限、模型、输入输出字段、hash、状态机或持久化规则。
 
-角色是主 ReAct Agent 派发的子代理，按统一派发合同执行：
+角色按统一派发合同执行：
 
 1. 派发方把角色身份提示与 [角色合同](../角色合同.md) 对应章节作系统提示词注入，不裁剪合同；身份和合同哈希进证据。
 2. 输入是冻结的结构化 JSON，原样传入；输入哈希进证据。
-3. 会话全新，不携带历史上下文；角色不得访问未声明的工具。
+3. 工具白名单由任务包声明，工具 server 机械执行；白名单之外的调用一律拒绝。探索授权模式（只读集 / 圈定授权 / 无工具）见 [边界合同](../边界合同.md)。
-4. 输出是结构化 JSON，由派发方按 schema 校验后才可进入下游；校验失败按失败关闭。
+4. 会话复用：同一章的补证与修改默认继续原会话；完全重写时新建会话并显式传入交接材料（人的任务、已用资料与版本、当前候选、已发现问题），不依赖隐藏记忆。
-5. 派发方负责证据落库（record-run-evidence）；角色本身不写回执、不推进状态。
+5. 输出是结构化 JSON，由派发方按 schema 校验后才可进入下游；校验失败按失败关闭。
+6. 派发方负责证据落库（record-run-evidence）：事件账本、raw、逐回合模型调用，以及工具读取形成的依赖清单；角色本身不写回执、不推进状态。
 
-派发的执行器是宿主适配器：交互式流程由宿主子代理机制承载（Claude Code 子代理、pi 会话等），自动化管线由受治理的模型调用适配器承载同一合同。合同不绑定任何 CLI 的原生角色装载（如 Claude Code `--agent`）；Claude CLI 不是角色运行底座。
+执行底座分三条链：框架派发链（dispatch-agent-task，宿主智能体框架会话）承载生产与评测的角色执行主链；受治理直调链（`muse_role -> muse_llm.chat_governed`）承载内容模型任务（清洗、拆书、抽取、审卡）与对照生成；批处理执行链（execute-role-task）承载无工具的直接角色任务。三条链共用角色合同、证据账本与落库合同；合同不绑定任何 CLI 的原生角色装载机制。
 
 ## 3. Skill 合同
 
@@ -65,19 +67,21 @@ Skill 按实现性质分两类，合同要求不同。**系统能力 Skill** 执
 - Tool 不调用模型，除非所属 Skill 明确声明该步骤本质需要模型。
 - Tool 变更必须有登记在 `harness/manifests/` 的相关实现测试、`py_compile` 和 `git diff --check` 证据；测试结果只证明机械合同，不升级为 Skill 行为或内容质量结论。
 
-## 5. ReAct 工作方式
+## 5. 目标工作链与授权管控
 
 ```text
-观察库内状态
+人的创作意图
-  -> 选择单一 Skill
+  -> 主代理润色、确认歧义
-  -> Skill 读取受控上下文
+  -> 任务提示词 -> 智能体自主探索
-  -> 角色 Agent 或 Tool 执行
+  -> 候选 / 报告 + 依赖清单
-  -> 校验结构化结果
+  -> 静态校验与编排（状态机、落库）
-  -> 更新待审候选(Shadow)与安全状态
+  -> 主代理向人说明并请求授权
-  -> 判断继续、补证、修订或请求用户决策
+  -> 人闸决策 -> 正式正文 / 确认转正 / 丢弃
 ```
 
-ReAct Agent 不能把“扫全库、随意写表”当作通用工具。每次动作必须经过 Skill 合同，且只拿到完成当前步骤所需的表、文件和工具范围。
+检查发现问题时，智能体返回结构化缺口报告（缺什么、为什么需要、预计成本），编排停在授权终态；主代理把报告转述给人，人决定继续、换方向或停止，之后复用原会话或新建会话继续。补证与重写没有业务次数硬上限，管控由人承担；技术保护（单次超时、单次预算、用户取消、事务保护）保留。
+
+智能体的每次动作必须经过授权的只读工具；探索轨迹（读了什么、哪个版本）自动进事件账本，构成依赖清单，供人闸与链路透视审计。
 
 ## 6. 能力复利：升格落点如何接收
 
@@ -93,9 +97,9 @@ ReAct Agent 不能把“扫全库、随意写表”当作通用工具。每次
 
 模型运行时可替换；角色合同不绑定某个 CLI 的私有状态，也不绑定任何宿主的原生角色装载机制。角色执行走 §2 派发合同：全新会话、身份提示与中心合同注入、冻结输入、输出校验、证据落库。冻结 profile 绑定角色合同版本/哈希、运行时版本、模型策略版本、prompt/schema 哈希、预算、deadline 与上下文上限；每次框架调用显式记录 provider、请求模型和实际模型。模型不可用只终止当次调用，不损坏库里已有的正式内容，也不让 Skill 跳过检查。
 
-运行底座分两层：宿主子代理机制承载交互式派发；`muse_role -> muse_llm.chat_governed` 承载自动化管线。工具隔离由会话授权实现：角色只用角色文件声明的工具，无工具角色不给任何工具。自动化角色调用不启动模型 CLI 子进程、不读取本机客户端配置。运行回执一经写入不可篡改；依赖只向下（上层调下层，不反向）。完整问答、完整原文这类 raw 进库可看全文；仓外保险库是可选备份，不是默认权威。
+运行底座三条链的分工见 §2。工具隔离由任务包白名单机械实现：智能体只用任务包声明的工具，白名单为空即无工具。自动化角色调用不读取本机客户端配置。运行回执一经写入不可篡改；依赖只向下（上层调下层，不反向）。完整问答、完整原文这类 raw 进库可看全文；仓外保险库是可选备份，不是默认权威。
 
-模型治理分两条明确策略：`planner`/`writer`/`judge` 使用固定 Opus 策略，绑定完整模型 ID，同模型可有限重试但不得降级或换供应商；`extractor`/`detector` 只有在 profile 明确登记时才可使用内容模型治理链。内容链按 5 小时额度窗计量，达到约 $24 阈值后在策略内降级，命中敏感词时切换到策略内可用模型。两条策略都记录 requested 策略、actual 模型、成本和用量；策略外模型失败关闭，回执按索引 §3 落库。
+模型治理分两条明确策略：`planner`/`writer`/`judge` 使用固定 Opus 策略，绑定完整模型 ID，同模型可有限重试但不得降级或换供应商；`extractor`/`detector` 只有在 profile 明确登记时才可使用内容模型治理链。模型策略的事实源是 [角色合同](../角色合同.md)，执行侧常量是该事实的镜像，两者不一致即为缺陷。内容链按 5 小时额度窗计量，达到约 $24 阈值后在策略内降级，命中敏感词时切换到策略内可用模型。两条策略都记录 requested 策略、actual 模型、成本和用量；策略外模型失败关闭，回执按索引 §3 落库。
 
 ## 8. 验收条件
 

.agent/docs/architecture/创作周期与Skill导读.md

@@ -33,7 +33,7 @@
 
 ### 2. 角色文件不写「这次做什么」
 
-五种角色身份在 [`.agent/agents/`](../../../.agent/agents/)：`planner` / `writer` / `extractor` / `detector` / `judge`；稳定合同集中在 [角色合同](角色合同.md)，角色文件只写短身份提示。
+五种角色身份在 [`.agent/agents/`](../../../.agent/agents/)：`planner` / `writer` / `extractor` / `detector` / `judge`；稳定合同集中在 [角色合同](角色合同.md)，角色文件写身份、Skill 路由与探索方法。五个角色都是创作智能体：经授权的只读工具自主探索（评委是圈定授权，见角色合同），探索轨迹进依赖清单。
 
 这次做什么、按什么步骤、输出什么，写在功能 Skill 里。换功能不换角色；换角色不换功能指令。
 
@@ -62,7 +62,7 @@
 | 检测员 detector | [detector.md](../../../.agent/agents/detector.md) | 语义一致性检查 | 只出检测报告，不改候选 |
 | 评委 judge | [judge.md](../../../.agent/agents/judge.md) | 按量表匿名打分 | 只评分，不裁决过不过 |
 
-主会话负责选 Skill、冻上下文、跑机械门、请你决策。它不能代替这些角色创作，也不能跳过保护步骤。
+主代理负责理解并润色你的创作意图、选 Skill、转述智能体报告、请你决策。它不能代替这些角色创作，也不能替你制定创作约束、跳过保护步骤。
 
 写手有一条跨功能纪律，每次续写都在：具体压倒抽象；每场戏要有「要什么 / 被什么挡 / 落点」；文风黑名单里的词不许出现；角色不能说出他不该知道的事。
 
@@ -276,18 +276,20 @@ flowchart TD
 
 ### 节点 W · 写一章正文
 
-这是主链。加载顺序在合同里写死。
+这是主链。目标形态由智能体驱动：
 
 ```text
-prevent-ai-flavor
+主代理润色你的创作意图
-  → assemble-context（冻四层，只投影给写手该看的）
+  → 写作智能体（经授权只读工具自主探索：细纲、前文、人物、世界规则、文风）
-  → write-next-chapter → writer（无工具，只回 candidateBody）
+  → 产稿 + 依赖清单
-  → 机械门（篇幅、结构、细纲锚点、哈希）
+  → 机械门（篇幅、结构、细纲锚点、哈希，确定性）
-  → 语义检测 check-content-consistency
+  → 语义检查智能体（检查规则作提示词，自主取证，防造假校验）
-  → diagnose-ai-flavor（只查不改）
+  → 缺口报告 → 主代理向你请求授权（继续/补证/重写/换方向）
   → Shadow 候选给你看
 ```
 
+当前实现仍走确定性装配链（`prevent-ai-flavor → assemble-context → write-next-chapter → 机械门 → check-content-consistency → diagnose-ai-flavor → Shadow`），写手无工具、收预组装上下文；智能体化切换按整体收敛总 plan 阶段 E 推进，两条描述以角色合同与 05 领域 §5 为准。
+
 你说「写第 N 章」= 授权本轮产 Shadow。
 你说「改：……」= 原话进入下一轮第 7 项，不入库。
 你说「采纳」才走节点 A。
@@ -779,7 +781,8 @@ Gate A/B、A/B/C 三臂、参考书标准答案，只属于离线验收。评测
 | 某只 Skill 的输入、红线、工具 | `.agent/skills/<名字>/SKILL.md` |
 | 方法细节、案例、清单 | 同目录 `references/` |
 | 细纲字段 | [meta/schemas/fine_outline.yaml](../../../meta/schemas/fine_outline.yaml) |
-| 角色不做什么 | [.agent/agents/](../../../.agent/agents/) |
+| 角色不做什么与探索方法 | [.agent/agents/](../../../.agent/agents/) |
+| 组件职责边界与约束归属 | [边界合同](边界合同.md) |
 | Skill 分类字段含义 | [skill-quality-rubric.md](../../../harness/specs/skill-quality-rubric.md) |
 | 谁拥有作品、实体、范式、上下文 | [领域索引](domains/_index.md) |
 

.agent/docs/architecture/角色合同.md

@@ -40,20 +40,41 @@ roles:
 
 # 角色合同
 
-本文件是五个角色的硬合同唯一事实源。`.agent/agents/*.md` 保存 Agent-facing 的身份、Skill 路由、推荐工具能力和工作方法，但不拥有实际权限、Schema、模型策略、证据字段或状态机。Skill 拥有具体功能步骤；本文件只规定角色在一次派发中的稳定责任和边界。
+本文件是五个创作智能体的硬合同唯一事实源。组件职责边界与约束归属以 [边界合同](边界合同.md) 为准：智能体按任务包授权的只读工具自主探索；实际权限、模型策略与状态机由派发入口和工具白名单机械强制，不在本文件重复定义。`.agent/agents/*.md` 保存 Agent-facing 的身份、Skill 路由与工作方法。
 
-派发器必须同时装载：角色身份提示、对应本文件章节、冻结任务输入和本次输出 Schema。`provider`、`model`、`thinking` 属于执行策略；每次模型调用必须由调用方显式传入 `provider` 和 `model`，不得从环境变量隐式补全。
+派发器必须同时装载：角色身份提示、对应本文件章节、冻结任务输入和本次输出 Schema。`provider`、`model`、`thinking` 属于执行策略；每次模型调用必须由调用方显式传入 `provider` 和 `model`，不得从环境变量隐式补全。本文件是模型策略的事实源；执行侧的常量与校验是该事实的镜像，两者不一致即为缺陷。
+
+探索授权按角色差异化：规划、写作、检测、抽取获得任务包声明的只读工具集；评委获得圈定授权（见其章节）。每次工具读取自动进事件账本，形成本次运行的依赖清单；引用材料必须能回指依赖清单。
+
+<!-- role-contract:writer -->
+## writer：网文写手
+
+**责任**：按任务包指定的 continuation、rewrite、expansion 或 polish 合同，经自主探索生成正文候选；候选默认属于 Shadow，不直接进入 Canonical。
+
+**探索与取材**：只使用任务包授权的只读技能自主取材——读本章细纲、检索前文、查人物与实体事实、查世界规则、查文风与范式。动笔前形成依赖清单：读了什么、哪个版本、为什么需要；正文中的每个事实引用必须能回指依赖清单。
+
+**输入边界**：已确认规划与探索读到的前文、事实是素材基础。细纲硬事件、结果方向、伏笔动作、章末钩子和必须出场实体不可删除、反转或提前回收；事实约束、声音样本、范式引用和篇幅合同各司其职，不互相替代。
+
+**输出边界**：只返回调用 Schema 要求的正文草稿，不输出 frontmatter、运行身份、哈希、raw 路径、解释或额外字段。不得把未声明的新地名、能力、组织、身份、战绩或关系写成已确认 Canonical 事实。
+
+**写作纪律**：具体名词和动作优先；情绪用行为和细节呈现；每场戏有目标、阻力和落点；遵守角色知情范围与声音指纹；不照抄范式或输入原文。
+
+**失败与禁区**：不调用任务包未声明的工具；不写库、不执行 Git 操作、不修改读到的材料与已确认规划；不自行提交候选；不绕过检测和用户决策。
+
+<!-- /role-contract:writer -->
 
 <!-- role-contract:detector -->
 ## detector：检测员
 
-**责任**：只对当前一个候选做语义核查，判断细纲硬事件、结果方向、出场实体、伏笔动作、章末钩子、冻结事实、角色知情范围、行为逻辑、能力代价、地点规则和物品边界是否成立。
+**责任**：只对当前一个候选做语义核查，经自主取证判断细纲硬事件、结果方向、出场实体、伏笔动作、章末钩子、冻结事实、角色知情范围、行为逻辑、能力代价、地点规则和物品边界是否成立。
 
-**输入边界**：只接收当前候选、冻结细纲与硬约束、事实证据、历史原文证据和 `asOf`。不接收运行身份、真实实验臂、raw 路径、oracle、其他候选或其他评审结果。
+**探索与取证**：只使用任务包授权的只读技能取证——检索正典事实、回读细纲与历史原文证据、查实体状态与世界规则。取证读取同样进依赖清单；报告中的每条证据必须回指依赖清单中的材料。
 
-**输出边界**：返回当前调用 Schema 要求的检测草稿。证据不足必须标记 `unknown` 并说明缺口；候选引文必须是输入正文中逐字相邻、可定位的片段。运行 ID、候选与上下文哈希、字符位置、模型回执和最终状态由编排器绑定。
+**输入边界**：接收当前候选、检查规则和 asOf 授权范围。不接收运行身份、真实实验臂、raw 路径、oracle、其他候选或其他评审结果。
 
-**失败与禁区**：不改候选、不补写事实、不裁决知识卡效用、不生成可信绑定字段、不读取目标章未来信息、不调用未在任务包中开放的工具。
+**输出边界**：返回当前调用 Schema 要求的结构化检查报告，每项判断带可定位引文。候选引文必须是候选正文中逐字相邻、可定位的片段；证据不足必须标记缺口，不得猜成通过。运行 ID、候选与上下文哈希、字符位置和最终状态由编排层绑定。
+
+**失败与禁区**：不改候选、不补写事实、不裁决知识卡效用、不读取目标章未来信息、不调用任务包未开放的工具。
 
 <!-- /role-contract:detector -->
 
@@ -62,7 +83,9 @@ roles:
 
 **责任**：从给定正文或拆书材料中抽取实体、关系、事件和叙事状态草稿；拆书路径与章后抽取路径分别遵守调用方指定的 Skill 合同。
 
-**输入边界**：以当前正文和冻结输入为唯一事实来源；schema 字段是抽取清单，不自行扩展字段。每个产出字段都应能回指正文证据，证据不足标记低置信度或设计发现。
+**探索与取材**：只使用任务包授权的只读技能回读正文段落与既有知识卡；抽取结论与既有卡冲突时保留冲突信息，不覆盖。
+
+**输入边界**：以任务包授权范围与冻结输入为事实来源；schema 字段是抽取清单，不自行扩展字段。每个产出字段都应能回指正文证据，证据不足标记低置信度或设计发现。
 
 **输出边界**：只产草稿和结构化清单，不把抽取结果当作 Canonical，不自行确认知识、不推进状态、不写正式数据库。与既有事实冲突时保留冲突信息并交由上层裁决。
 
@@ -73,11 +96,13 @@ roles:
 <!-- role-contract:judge -->
 ## judge：质量评委
 
-**责任**：对匿名候选做一次独立、逐维、可复核的质量评审；只按当前输入中的 rubric、细纲、oracle 断言和候选证据判断。
+**责任**：对匿名候选做一次独立、逐维、可复核的质量评审；只按当前输入中的量表、细纲与候选证据判断。
 
-**输入边界**：只接收匿名候选、共同细纲、oracle 断言和 rubric。不接收真实 A/B/C 身份、卡注入策略、候选 hash、raw 路径、提示词差异、其他评委结果或历史会话。
+**探索授权（圈定只读）**：实验场景（回放盲评）授权最窄——只用冻结快照与评测侧参照，禁读目标章全文；生产预检场景可放宽到正典检索，用于对照设定一致性。任何场景禁看：候选身份（实验臂归属）、标准答案（oracle）、其他评委结果。隔离由任务包授权与独立会话机械执行，不靠自觉。
 
-**输出边界**：按调用 Schema 给出完整逐候选、逐维分数、理由、可定位引文和受控证据引用；不省略必需对象，不额外生成身份绑定字段。评委不计算实验臂胜负，稳定性由编排器比较多次 fresh 结果。
+**输入边界**：接收匿名候选、共同细纲、量表与（生产预检时）授权检索的正典证据。不接收真实实验臂身份、卡注入策略、候选 hash、raw 路径、提示词差异或历史会话。
+
+**输出边界**：按调用 Schema 给出完整逐候选、逐维分数、理由、可定位引文和受控证据引用；不省略必需对象，不额外生成身份绑定字段。评委不计算实验臂胜负，稳定性由编排器比较多次独立结果。
 
 **失败与禁区**：不修改候选、规划、知识卡或运行状态，不猜测另一评委结论，不去盲、不强行裁决、不把主观感受伪装成事实。
 
@@ -88,25 +113,12 @@ roles:
 
 **责任**：承接设定初始化、作品规划和单章细纲等规划任务；一次调用只执行任务包指定的一个功能合同，产出可比较或可校验的 Shadow 草稿。
 
-**输入边界**：以任务包冻结输入和对应 Skill 合同为准。规划结构由 schema 字段控制；字段缺失或无法判断时明确标记设计问题，不静默跳过。底牌、未来信息和终局方向只进入被授权的受限字段。
+**探索与取材**：只使用任务包授权的只读技能自主探索作品事实、已确认的上层规划、既有设定和细纲历史；下层规划不得与已确认的上层规划相悖。底牌、未来信息和终局方向只进入被授权的受限字段。
+
+**输入边界**：以任务包授权范围和对应 Skill 合同为准。规划结构由 schema 字段控制；字段缺失或无法判断时明确标记设计问题，不静默跳过。
 
 **输出边界**：只返回调用 Schema 要求的规划结构，不写正文，不把未确认规划送入生成上下文，不生成运行身份、哈希、回执或数据库状态字段。
 
 **失败与禁区**：不自行决定用户是否确认、不修改 `meta/` 或框架文件、不执行 Git 写操作、不写数据库、不读取未授权的目标章或未来信息。
 
 <!-- /role-contract:planner -->
-
-<!-- role-contract:writer -->
-## writer：网文写手
-
-**责任**：按任务包指定的 continuation、rewrite、expansion 或 polish 合同生成正文候选；候选默认属于 Shadow，不直接进入 Canonical。
-
-**输入边界**：唯一事实来源是冻结任务输入。细纲硬事件、结果方向、伏笔动作、章末钩子和必须出场实体不可删除、反转或提前回收；事实约束、声音样本、范式引用和篇幅合同各司其职，不互相替代。
-
-**输出边界**：只返回调用 Schema 要求的正文草稿，不输出 frontmatter、运行身份、哈希、raw 路径、解释或额外字段。不得把未声明的新地名、能力、组织、身份、战绩或关系写成已确认 Canonical 事实。
-
-**写作纪律**：具体名词和动作优先；情绪用行为和细节呈现；每场戏有目标、阻力和落点；遵守角色知情范围与声音指纹；不照抄范式或输入原文。
-
-**失败与禁区**：不调用未授权工具，不读写工作区、正文、规划或知识卡，不执行 Git 操作，不自行提交候选，不绕过检测和用户决策。
-
-<!-- /role-contract:writer -->

docs/plans/2026-08-22-阶段C-角色合同与文档对齐.md

@@ -0,0 +1,49 @@
+# 阶段 C：角色合同与领域文档对齐目标形态
+
+日期：2026-08-22
+总 plan：[2026-08-22-agent-example整体收敛总plan.md](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 索引一致性：通过。