muse-agent-example/meta/chains/README.md

# meta/chains —— 功能链登记表（G2 治理对象）

对齐：功能链的定义/版本/节点/槽位与 MetaSchema 同族、同住 Meta BC（专题-06 §2）；节点与保护语义=专题-03 §2；scenario 清单=专题-03 §4.1。

## prompt 三段式与载体

agent 的提示词按**变化轴**拆三段，不做"一个 agent 一个大 prompt"，也不按功能裂 agent：

- **身份段**（`.agent/agents/*.md`）：人设/元数据纪律/跨功能纪律/红线——跨功能共享；
- **功能指令段**（**载体=功能 Skill**，由下表显式登记 scenario→Skill）：这次"做什么、按什么步骤、什么输出合同"——派发时只加载**本次功能**的 Skill，其余功能指令不进上下文；每只功能 Skill 必须有「元数据驱动」节，写明 schema 怎么控制该功能；
- **L0 任务特化**（`assemble-context` 组装）：本回合参数。

换功能不换 agent、换 agent 不换功能指令，两轴正交。功能指令是元数据：改指令产出立变、agent 一行不改。对应 muse：身份段=agent_version.config 的 prompt；功能指令段=功能链节点/槽位的场景合同；同一 agent 经 slot_bindings 绑多个功能槽位。本目录是**链登记表**：哪条 scenario、经过哪些保护节点、挂哪个槽位、功能合同在哪只 skill。

## 功能链登记（scenario → 功能 skill → 挂靠）

| scenario | 功能 skill | 槽位/agent | purpose | 保护节点序列(简化) | 状态 |
|---|---|---|---|---|---|
| continuation 续写 | `write-next-chapter` | 写作→writer | generation | assemble-context→无工具 writer→机械门→语义 detector→Shadow→用户三决策→accept_preflight→正式写入→异步抽取 | 生产链已闭环:机械门+真实语义 detector+持久 CAS 链+accept_preflight+正式写入(write_canonical 单事务,含已批准事实增量与投影登记);语义缺口补证重组装已接(production_evidence_reassemble);章后抽取的异步执行未建(抽取投影只登记 pending) |
| rewrite 改写 | `rewrite-selection` | 写作→writer | generation | 同上+expectedRevision 核对 | 已建 |
| expansion 扩写 | `expand-scene` | 写作→writer | generation | 同 continuation | 已建 |
| polish 润色 | `polish-prose` | 写作→writer | generation | 同 continuation(只动表达层) | 已建 |
| setting_init 作品设定初始化 | `design-story-foundation` | 规划→planner | planning | 用户冻结根设定与对话→隔离候选→离线机械门→用户选择→交给 planning | 手工前置流程首建；候选不落库、不进 Canonical |
| planning 规划 | `plan-story` | 规划→planner | planning | assemble-context(planning 视图)→槽位→用户确认(decide-candidate) | 已建 |
| fine_outline 细纲规划 | `plan-chapter` | 规划→planner | planning | assemble-context(fine_outline 冻结视图)→槽位→check-content-consistency→score-content-quality | 评测版首建(2026-07-19) |
| full_parse 拆书 | `deconstruct-book` | 分析→extractor | extraction | import-book 分章→逐章槽位→access-database 落 draft→管理员确认(G3 门) | 已建;B2 PG 版首验 |
| ai_flavor_capture AI 味案例回填/反馈 | `capture-ai-flavor-cases` | 检测→detector | detection | 作品/创作反馈→检测完成自动落库→hash 与位置门→Shadow 案例卡 | 已建;默认写入 muse-example，`--offline` 仅作显式离线回放 |
| knowledge_confirm 知识卡确认 | `confirm-knowledge-draft` | 主权→用户确认 | extraction | 抽取/拆书产出 draft→用户确认→实体/关系/active 向量 owner | 已建;与正文轨 `decide-candidate` 表集不交 |
| extraction 章后抽取 | `extract-chapter-knowledge` | 分析→extractor | extraction | 采纳后触发→槽位→草稿/冲突队列→decide-candidate | 已建;C5 首验 |
| validation / consistency_check 检测 | `check-content-consistency` | 检测→detector | detection | assemble-context(detection 视图)→槽位→报告落评审/ | 已建 |
| quality_gate 评分 | `score-content-quality` | 保护节点→judge | 基线包=writer 视图 | 基线包→judge→optimize-content-quality 归因建议 | 已建 |
| writer_gate 裁决 | `adjudicate-quality-gate` | 保护节点→裁决 | 逐样本脱敏结果 | 逐样本结果→gate input 构建→Gate A/B 终态→receipt 落 CAS | 已建;终态唯一来源，评分与编排层都不得改写 |
| writer_replay 正文回放 | `replay-writer-gate` | 评测→writer/judge | evaluation | load-replay-reference-work 装配→三臂 WriterContext→写手→盲评→adjudicate-quality-gate | 已建;Gate A 预注册深空之影五章 |
| voice_baseline 定基线 | `establish-voice-baseline` | 规划→planner | planning | Canonical 正文→统计候选账→语义补充→grounding→人工确认→版本化落库 | 已建;v2先行验证，角色策略仍需作者/模型补充 |
| deai_prevention 前置预防 | `prevent-ai-flavor` | assemble-context 消费 | generation | current 声音账+active规则四类样例→结构化合同→WriterContext冻结 | 已建;v2已接 assemble-context |
| deai_diagnose 诊断 | `diagnose-ai-flavor` | 检测→detector | detection | 五层/载体scope检测→发现清单→检测完成即落库 | 已建;语义层仍需外部判定 |
| deai_revise 修订 | `revise-ai-flavor` | 写作→writer+保护节点 | generation | 诊断+作者授权+仲裁→最小 patch→事实/声音门→复扫→成对选择 | 已建;跨轮编排由上层承接 |
| ai_flavor_mining 挖掘 | `promote-ai-flavor-rule` | 检测→detector | detection | 卡落库→标注→verified确认→样例投影→规则评测→人工激活/降级 | 已建;holdout/调度仍需积累 |
| setting_merge 前期候选统合 | `merge-story-candidates` | 规划→planner | planning | 多份候选→逐章串行统合→主会话审定→回写 SoT | 已建;模型治理待接 call-content-model |

## 去 AI 味五技能接力铁律（专题-09 §6.1）

- 主链顺序不可跳级：**生成 → 诊断（deai_diagnose）→ 最小修订（deai_revise）→ 门禁 → 人确认**。没诊断不能改；没人确认不能转正。
- 定基线（voice_baseline）是垫底资产：作品建立/新角色登场时跑，平时不动；它是修订门禁与前置预防的对照物。
- 前置预防（deai_prevention）只降低命中率，不承诺零 AI 味；漏网命中由诊断兜底。
- 挖掘（ai_flavor_mining）不碰本次正文，只在背后进化规则库；升格入口是 `promote-ai-flavor-rule`，规则候选必须过双来源+正反证据+装载门+评测才可能 active。
- **周期挂载**：以创作**正式权威**变没变为界——检查、报告、accept 授权后的下游 shadow 草稿可自动；草稿转正式与规则激活须人。见 [05 §2](../../.agent/docs/architecture/domains/05-创作流程领域.md)（含交互回合合同 §2.3 与节点 Skill 矩阵 §2.4）。
- 五技能共享的资产层在 [`humanization/`](../../humanization/)：初始拷贝自父仓 muse-deai，验证期由本仓自治演进，升华进 Muse 时才同步回父仓。

## 公约

- 功能细节约束一律住功能 skill,agent 身份段只留跨功能部分;新增 scenario 先在此登记再建 skill;
- 递送机制(阶段一):功能 skill 由**主会话内联**——派发时读 SKILL.md 正文塞进派发 prompt 的功能指令段位;不用子代理 `skills:` 预加载(它会把列出的全部注入,违反「一次只带本次功能」),子代理无需 Skill 工具;
- 拼装位置:身份段之后、增量段之前(见 assemble-context 拼装序);同功能多回合间稳定,吃缓存;
- purpose 由 scenario 映射(生成类→generation、抽取类→extraction、规划→planning、检测类→detection),purpose 定字段可见集(aiContext),scenario 定功能 skill 与 L0 形态,两者不混;
- 链登记与实况漂移=G2 治理缺陷,发现即修。

## 正文候选 v1 三决策合同

- `accept`：用户明确确认后，对当前候选运行实时 `accept_preflight`；通过后写 Canonical，并**授权**下游 shadow 草稿自动生成（章后抽卡、案例/规则候选）；草稿转正式仍须人。`expectedRevision`、detector、上下文、策略、授权、来源或有效期任一不满足即失败关闭。
- `merge` / **改**：用户编辑或「改：…」必须生成严格下一 `candidateVersion` 和新正文 hash（或整轮重产），重新运行 detector 后再进入 Shadow；禁止“修改后直接合并”。
- `discard`：用户明确确认后只关闭候选；可授权重产。
- `check_writer_acceptance.py` 是无副作用纯函数，不写 Canonical，只做接受前置检查（实时状态重读由 `acceptance_state.py` 提供）。正式提交层 `write_canonical.accept` 在 DB 级兜底复检 `state=passed` 且 `semantic_status=passed`（先审后入），同事务合并已批准事实增量并登记章后抽取投影——投影可 pending；异步抽卡执行待建，但 `next_steps` 须标明 accept 已授权自动草稿。