框架: prompt三段式定版——身份段(agent.md)×功能指令段(meta/chains/新目录,每scenario一份只拼本次)×L0特化;scenario/purpose两概念分离;skill辅助映射入README

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
lili 2026-07-09 09:03:53 -07:00
parent fea8adbb5f
commit 8d3d5f32fb
3 changed files with 40 additions and 5 deletions

View File

@ -7,7 +7,7 @@ description: 组装智能体上下文包——统一创作数据读取器(专题
SoT 对齐:包结构=专题-03 §4.2 **四层上下文**;字段级 aiContext 裁剪=专题-06 §7 统一读取器。
**输入**:作品名、用途(scenario:`planning` / `generation` / `detection` / `extraction`)、目标(如"写第7章")
**输入**:作品名、功能(scenario,专题-03 §4.1:continuation/rewrite/expansion/polish/extraction/full_parse/planning/validation/consistency_check/quality_gate)、目标(如"写第7章")。**用途(purpose)由 scenario 映射**——生成类→`generation`,抽取类→`extraction`,规划→`planning`,检测类→`detection`,quality_gate→基线包即 writer 视图;purpose 定字段可见集(aiContext),scenario 定功能指令段(`meta/chains/`)与 L0 形态,两者不混
## 步骤
@ -32,7 +32,7 @@ SoT 对齐:包结构=专题-03 §4.2 **四层上下文**;字段级 aiContext 裁
- **公共范式**:仅 `装配.yaml` 已绑定的库;按本章场景类型选卡(如打斗章带打斗卡),不整库带入;extractor/judge 此层关闭(见差异矩阵)。
4. 产出**上下文包**——两个顺序必须分开:
- **预算序**(谁不许被裁,对齐专题-03 §4.2):L0 必须完整保留;超长先摘要化 L3→L2,再截 L1,永不动 L0;
- **拼装序**(物理顺序,按稳定度递减,吃 prompt 前缀缓存):**通用系统位**(一句极简声明,全 agent 相同) → **章级基线包**(跨 agent 共享缓存段)=L2 作品事实+L1 近邻正文+L0 稳定部(本章细纲),**按 writer 的 generation 可见集组装**(最保守视图:底牌全闭) → **agent 身份段**(角色指令=agent prompt 正文,后置于基线包) → **agent 增量段**(差异矩阵的增量,**只加不减**:detector 补底牌+知识全集/extractor 补 schema 合同+既有知识/judge 补 rubric/planner 补底牌+未来粗纲;L3 授权资料/检索结果;待检待评对象) → **L0 易变部**=用户本回合意图/修改意见(每回合必变,**绝对尾置**,亦是遵循度最优位)。
- **拼装序**(物理顺序,按稳定度递减,吃 prompt 前缀缓存):**通用系统位**(一句极简声明,全 agent 相同) → **章级基线包**(跨 agent 共享缓存段)=L2 作品事实+L1 近邻正文+L0 稳定部(本章细纲),**按 writer 的 generation 可见集组装**(最保守视图:底牌全闭) → **agent 身份段**(角色指令=agent prompt 正文,后置于基线包) → **功能指令段**(`meta/chains/` 本次 scenario 的一段,其余功能指令不进上下文;同功能多回合稳定) → **agent 增量段**(差异矩阵的增量,**只加不减**:detector 补底牌+知识全集/extractor 补 schema 合同+既有知识/judge 补 rubric/planner 补底牌+未来粗纲;L3 授权资料/检索结果;待检待评对象) → **L0 易变部**=用户本回合意图/修改意见(每回合必变,**绝对尾置**,亦是遵循度最优位)。
- 跨 agent 复用机理:同章流水线(writer→detector→judge→extractor)基线包**字节一致**(本 skill 必须确定性渲染:同序、无时间戳),首跑写缓存(+25%),后续 agent 读缓存(1/10 价)。安全性两头锁死:基线=writer 视图保证**无人多看**(writer 基线 ⊆ 其余各 agent 可见面);增量只加不减保证**无人少看**。同一 agent 的重生成/复评环在此之上再吃更长前缀。
- 缓存注记:L3 检索查询尽量从本章细纲构造,意图只在用户点名新参考时追加——使 L3 章内趋稳,同章 n=5 重生成环吃到更长前缀。
- 归属判据(什么进身份段,什么进层):**换作品也不变**的进 agent 身份段(角色/方法论/agent 级输出合同/红线);**随作品变**的进 L2(文风画像/设定——身份段不得硬编任何作品专属内容,这是「换绑写手不动链」的前提);**随回合变**的进 L0 易变部。**种子=prompt 文本,位置=装配层决定**。

View File

@ -33,6 +33,7 @@ agent-example/
│ ├── agents/ ← 动脑的:writer / planner / extractor / detector / judge
│ └── skills/ ← 动手的:read-context(组装上下文) / confirm(确认提交) / eval(质量收敛)
├── meta/schemas/ ← 23 型结构本体设计稿(对齐专题-06;README 有实例落点表)
├── meta/chains/ ← 功能链与功能指令设计稿(prompt 三段式的功能段;G2 治理对象)
├── knowledge/ ← 跨作品层:参考书原文 + 拆书产出的公共范式卡(绑定才进上下文)
└── works/<书名>/
├── 设定.md ← 作品容器+作品核心+世界观总纲+文风画像(四节一文件)
@ -70,6 +71,8 @@ agent-example/
SoT 第三层「知识基座」(检索/切块/入库,明文不是 app在实验里即 **skill 层**db/import/embed/search——正好印证「所有 API/工具皆 skill」。分工判据需要 LLM 判断的进 agent确定性的取数、写库、外部调用、流程管控进 skillLLM 参与但属主权裁决的落保护节点不开放装配。agent 只经 skill 拿上下文与落库。
**prompt 三段式**(见 `meta/chains/README.md`身份段agent .md跨功能共享× 功能指令段meta/chains/ 每 scenario 一份,派发只拼本次一段)× L0 任务特化——不做一个 agent 一个大 prompt防指令稀释也不按功能裂 agent防身份复制。**skill 辅助映射**extractor 最重db 读 schema 与既有知识、产出经 db 写入 draft、embed 嵌入writer/planner/detector 经 read-context 取数、PG 版加 search 召回judge 零外部依赖(基线包+rubricimport 是纯确定性工具LLM 不参与。
**LLM 能力功能全覆盖对照**SoT 功能 → 实验落点,防漏配):写作 7 功能(续写/改写/扩写/润色/纠错/去AI味/角色声音→writer规划 5 动作(生成/补全/整理/检查/多方案,产品-03 §3.5→planner分析 6 功能(目标分析/实体解析/候选草稿提取/全书解析/章节抽取/结构拆解→extractor检测 5 检查(风险/一致性/角色声音/文风/语义偏离→detector质量评分 8 维(专题-043 叙事关键+5 非关键→judge**有限重写**≤2 次,专题-04 §5→eval 环承担judge 诊断+writer 重生成,人在环);**合规与语义围栏**→不镜像(阶段一由平台安全层承担,阶段二真后端承接);**组装内摘要化**超预算先摘要低层→read-context 流程内动作;**嵌入/重排**→embed/search skill第三层模型能力非 agent**硬阻断 3 维**(来源安全/输出合规/静态结构→规则层检查skill/流程承担,不进评委职权。
### 上下文组装结构SoT=[专题-03 §4 四层上下文](../design-docs/专题-03-AI编排上下文与质量评测实现规范.md) + [专题-06 §7 统一读取器](../design-docs/专题-06-元数据驱动的智能体架构.md);操作细节以 read-context skill 为准)
@ -83,8 +86,8 @@ SoT 第三层「知识基座」(检索/切块/入库,明文不是 app
预算顺序:先留输出预算 → L0 完整保留 → L1 优先 L2 优先 L3;超限先摘要化低层再截断
拼装顺序(物理序,与预算序是两回事,按稳定度递减):
通用系统位(全 agent 相同) → 章级基线包(L2+L1+L0稳,按 writer 视图组装,跨 agent 共享缓存)
→ agent 身份段(角色指令后置) → agent 增量段(底牌/全集/rubric/L3 检索结果,只加不减)
→ L0易变部(用户本回合意图,绝对尾置)
→ agent 身份段(角色指令后置) → 功能指令段(meta/chains/,只拼本次 scenario 一段)
agent 增量段(底牌/全集/rubric/L3 检索结果,只加不减) → L0易变部(用户本回合意图,绝对尾置)
——同章流水线 writer 首跑写缓存,后续 agent 按 1/10 价读;基线=writer 视图锁"无人多看",
增量只加锁"无人少看";阶段一子代理机制钉系统位不落此布局,阶段二 Context Assembly 落
裁剪回显(落 评审/,验收证据):字段级=aiContext 裁剪清单(专题-06 §7)
@ -161,7 +164,7 @@ flowchart LR
| A1原K0 | 基座 | `muse-example` 建库+vector 插件嵌入通道已实测Qwen3-8B 默认 4096、`dimensions:1024` 生效) | psql 实测输出 | 未做,第一步 |
| A2原K1 | 库表映射 | 主仓 `sql/muse` 摘录**一致** DDLmeta / work·chapter / knowledge 三域)→应用;实验私货全进 `example_*` 前缀(嵌入边表 vector(1024)、tenant/creator 默认系统主账号=1交付 `db` 查询 skill | `\dt` + 表↔主仓迁移来源映射 | 未做 |
| A3原K2 | G1 元结构治理 | 23 型 YAML → meta 表行(=W1 种子演练);此后拆书/抽取一律读**库内** schema | schema/字段行卡片打印 | YAML 就绪,入库未做 |
| A4 | G2 系统能力治理 | 四槽位默认智能体 + read-context/confirm/eval 保护流程 | 保护节点不可被装配替换 | 已就位(文件侧);装配入库随阶段二 |
| A4 | G2 系统能力治理 | 四槽位默认智能体 + read-context/confirm/eval 保护流程 + 功能链指令设计稿(`meta/chains/` | 保护节点不可被装配替换 | 身份段已就位;链文件按 B2/C 线交付 |
**阶段B 全局知识生产(管理线 G3 主体;审查=可见知识库数据)**

32
meta/chains/README.md Normal file
View File

@ -0,0 +1,32 @@
# meta/chains —— 功能链与功能指令设计稿G2 治理对象)
对齐:功能链的定义/版本/节点/槽位与 MetaSchema 同族、同住 Meta BC专题-06 §2节点与保护语义=专题-03 §2scenario 清单=专题-03 §4.1。本目录是实验侧的功能链设计稿,验证后回填。
## prompt 三段式(为什么有这个目录)
agent 的提示词按**变化轴**拆三段,不做"一个 agent 一个大 prompt",也不按功能裂出一堆 agent
- **身份段**`.claude/agents/*.md`):人设/方法论/红线——跨功能共享,换功能不重写;
- **功能指令段**(本目录,每 scenario 一份):这次"做什么、按什么步骤、输出什么合同"——派发时只拼**本次功能**的一段,其余功能的指令一律不进上下文(防大 prompt 稀释指令遵循);
- **L0 任务特化**read-context 组装):本回合参数。
换功能不换 agent、换 agent 不换功能指令两轴正交。功能指令是元数据改指令产出立变、agent 一行不改——元数据驱动的又一活体证明。对应 muse身份段=agent_version.config 的 prompt功能指令段=功能链节点/槽位的场景合同;同一 agent 经 slot_bindings 绑多个功能槽位。
## scenario 清单(专题-03 §4.1)与交付节奏
| scenario | 挂靠 agent | 用途(purpose) | 状态 |
|---|---|---|---|
| full_parse拆书/全书解析) | extractor | extraction | B2 交付 |
| extraction章后抽取 | extractor | extraction | B2 首验 / C5 复用 |
| planning规划 | planner | planning | C2 到场景再写 |
| continuation续写 | writer | generation | C4 到场景再写 |
| rewrite / expansion / polish | writer | generation | C 线按需 |
| validation / consistency_check检测 | detector | detection | C4 伴随 |
| quality_gate评分 | judge | 基线包=writer 视图 | C6rubric 暂在 judge.md建链时迁出 |
## 公约
- 建某链时,把 agent `.md` 里该功能专属的内容迁出到链文件,身份段只留跨功能部分;
- 链文件内容=节点序列(经过哪些保护节点/哪个开放槽位)+ 场景指令 + L0 形态 + 输出合同;
- 拼装位置:身份段之后、增量段之前(见 read-context 拼装序);同功能多回合间此段稳定,吃缓存;
- purpose 由 scenario 映射生成类→generation、抽取类→extraction、规划→planning、检测类→detectionpurpose 定字段可见集aiContextscenario 定功能指令段与 L0 形态,两者不混。