44 lines
4.6 KiB
Markdown
44 lines
4.6 KiB
Markdown
# meta/chains —— 功能链登记表（G2 治理对象）
|
||
|
||
对齐：功能链的定义/版本/节点/槽位与 MetaSchema 同族、同住 Meta BC（专题-06 §2）；节点与保护语义=专题-03 §2；scenario 清单=专题-03 §4.1。
|
||
|
||
## prompt 三段式与载体
|
||
|
||
agent 的提示词按**变化轴**拆三段，不做"一个 agent 一个大 prompt"，也不按功能裂 agent：
|
||
|
||
- **身份段**（`.claude/agents/*.md`）：人设/元数据纪律/跨功能纪律/红线——跨功能共享；
|
||
- **功能指令段**（**载体=功能 skill**，`.claude/skills/<scenario>/SKILL.md`，每 scenario 一只）：这次"做什么、按什么步骤、什么输出合同"——派发时只加载**本次功能**的 skill，其余功能的指令不进上下文（防指令稀释）；每只功能 skill 必须有「元数据驱动」节，写明 schema 怎么控制该功能；
|
||
- **L0 任务特化**（read-context 组装）：本回合参数。
|
||
|
||
换功能不换 agent、换 agent 不换功能指令，两轴正交。功能指令是元数据：改指令产出立变、agent 一行不改。对应 muse：身份段=agent_version.config 的 prompt；功能指令段=功能链节点/槽位的场景合同；同一 agent 经 slot_bindings 绑多个功能槽位。本目录是**链登记表**：哪条 scenario、经过哪些保护节点、挂哪个槽位、功能合同在哪只 skill。
|
||
|
||
## 功能链登记（scenario → 功能 skill → 挂靠）
|
||
|
||
| scenario | 功能 skill | 槽位/agent | purpose | 保护节点序列(简化) | 状态 |
|
||
|---|---|---|---|---|---|
|
||
| continuation 续写 | `continuation` | 写作→writer | generation | read-context→无工具 writer→机械门→语义 detector→Shadow→用户三决策→accept_preflight→正式写入→异步抽取 | v1 接口与机械门已建;真实语义 detector、正式写入和抽取接线未建 |
|
||
| rewrite 改写 | `rewrite` | 写作→writer | generation | 同上+expectedRevision 核对 | 已建 |
|
||
| expansion 扩写 | `expansion` | 写作→writer | generation | 同 continuation | 已建 |
|
||
| polish 润色 | `polish` | 写作→writer | generation | 同 continuation(只动表达层) | 已建 |
|
||
| planning 规划 | `planning` | 规划→planner | planning | read-context(planning 视图)→槽位→用户确认(confirm) | 已建 |
|
||
| fine_outline 细纲规划 | `fine-outline` | 规划→planner | planning | read-context(fine_outline 冻结视图)→槽位→detect→quality-gate | 评测版首建(2026-07-19) |
|
||
| full_parse 拆书 | `parse-book` | 分析→extractor | extraction | import 分章→逐章槽位→db 落 draft→管理员确认(G3 门) | 已建;B2 PG 版首验 |
|
||
| extraction 章后抽取 | `extract-knowledge` | 分析→extractor | extraction | 采纳后触发→槽位→草稿/冲突队列→confirm | 已建;C5 首验 |
|
||
| validation / consistency_check 检测 | `detect` | 检测→detector | detection | read-context(detection 视图)→槽位→报告落评审/ | 已建 |
|
||
| quality_gate 评分 | `quality-gate` | 保护节点→judge | 基线包=writer 视图 | 基线包→judge→eval 环(有限重写) | 已建 |
|
||
|
||
## 公约
|
||
|
||
- 功能细节约束一律住功能 skill,agent 身份段只留跨功能部分;新增 scenario 先在此登记再建 skill;
|
||
- 递送机制(阶段一):功能 skill 由**主会话内联**——派发时读 SKILL.md 正文塞进派发 prompt 的功能指令段位;不用子代理 `skills:` 预加载(它会把列出的全部注入,违反「一次只带本次功能」),子代理无需 Skill 工具;
|
||
- 拼装位置:身份段之后、增量段之前(见 read-context 拼装序);同功能多回合间稳定,吃缓存;
|
||
- purpose 由 scenario 映射(生成类→generation、抽取类→extraction、规划→planning、检测类→detection),purpose 定字段可见集(aiContext),scenario 定功能 skill 与 L0 形态,两者不混;
|
||
- 链登记与实况漂移=G2 治理缺陷,发现即修。
|
||
|
||
## 正文候选 v1 三决策合同
|
||
|
||
- `accept`：用户明确确认后，对当前候选运行实时 `accept_preflight`；`expectedRevision`、detector、上下文、策略、授权、来源或有效期任一不满足即失败关闭。
|
||
- `merge`：用户编辑必须生成严格下一 `candidateVersion` 和新正文 hash，重新运行 detector 后再进入 Shadow；禁止“修改后直接合并”。
|
||
- `discard`：用户明确确认后只关闭候选，不返回抽取命令意图。
|
||
- 实验台 `check_writer_acceptance.py` 是无副作用纯函数，不写 Canonical。`accept/merge` 通过时只返回当前不可派发的提交后副作用意图（`allowed=false`、`requiresCanonicalCommit=true`）；正式提交层验证 Canonical 提交凭证后才可异步排队章后抽取。本轮没有接入正式正文库或抽取进程。
|