6元素提示词组装管线拆解:awesome-novel-agent 冲突裁定与稀疏注入如何告别AI味写作
6元素提示词组装管线拆解:awesome-novel-agent 冲突裁定与稀疏注入如何告别AI味写作
awesome-novel-agent 是一个让 AI agent 成为小说创作搭档的开源项目:从世界观搭建、角色塑造,到章节规划、正文写作,一步步陪你写完整部小说。本文拆解它最核心的 6 元素提示词组装管线——当章纲、文风、反 AI 规则、场景方法论十几份材料同时涌进来时,系统靠冲突裁定优先级和稀疏注入两个设计,把信息精炼成一份"writer 拿到就能动笔"的纯净提示词。
一、先看懂全景:AI 写小说的"工厂流水线"
awesome-novel-agent 的核心是一套状态驱动循环(OBSERVE → THINK → ACT → VERIFY → LOOP)。主 agent(novel-agent)像总指挥,按项目所处阶段调度 8 个子 agent:
| 阶段 | 负责的 agent | 干什么 |
|---|---|---|
| outline | volume-planner / chapter-planner | 卷纲、章纲规划 |
| draft | prompt-crafter | 6 元素提示词组装(本文主角) |
| draft | writer | 按提示词写正文 |
| anti-ai | anti-ai | 检测并清除"AI 味" |
| archive | updater | 归档、维护设定与记忆 |
整条数据流可以简化为:
章纲(chapter.md) → prompt-crafter 组装 6 元素提示词
→ prompts/vol-{N}-ch-{M}-prompt.md → writer 写正文 → 后续清创/归档
这里最容易踩坑的地方在于:提示词的输入源多达 10 类——文风主卡、上一章章纲、角色设定、题材示例、反 AI 规则、写作记忆、永久记忆、场景风格卡……它们彼此经常打架:
- 文风卡说"多用长句渲染氛围",字数约束却要求"本章 ≤ 3000 字";
- 场景方法论说"感官要细腻",反 AI 规则却要求"每场景 ≤ 2 种感官";
- 作者记忆说"对话要短",题材基线却说"对话要有仪式感"。
如果没有统一的裁决机制,提示词就会变成一堆互相矛盾的指令。这正是下面两个设计要解决的问题。
二、6 元素提示词结构:组装的"骨架"
管线按固定骨架填充 6 个元素(完整填充规则见 skills/prompt-crafting.md):
| 元素 | 装什么 | 输入来源 |
|---|---|---|
| 角色 | 题材定位(照抄不展开) | genre-setting |
| 任务指示 | 章号、字数与压缩策略、叙事目标、写作方法论 | 章纲 memo + 卷纲 + 文风 |
| 背景信息 | 前情上下文(上章结尾画面)、作者偏好记忆、角色初始状态 | 上一章章纲 + 记忆系统 |
| 案例 | 经"四步转化"的场景写法示范 | 场景方法论 |
| 输入 | 场景原材料(2-4 个场景卡)+ 段落分解 | 章纲场景卡 |
| 输出 | 不可违反规则 + 场景写作指引 + 质感要求 | 冲突裁定结果汇总 |
注意一个细节:输出是扁平化的——写作规范、叙事规则、约束红线合并成一个"不可违反规则"列表,按优先级从高到低排列,减少 writer 在多层嵌套之间做取舍的判断成本。
三、冲突裁定优先级表:规则打架时听谁的
当填充过程中遇到冲突,管线在 Step 1.5 预加载一张全局冲突裁定表(内部参考,不写进提示词)。这是整条管线的"宪法",优先级从高到低共 6 级:
| 优先级 | 规则 | 冲突时的裁定 |
|---|---|---|
| 1(最高) | 约束红线 | 情节红线、角色禁区、边界禁止——任何时候不得删改,字数压缩也不能牺牲红线 |
| 2 | 字数 | 硬性约束(±10%)。超限时启用压缩策略:先压低权重场景,高权重场景的核心冲突段落不动 |
| 3 | T1 词(仿佛/一丝/不禁…) | 超阈值时保留有叙事功能的,删掉无功能的赘词 |
| 4 | 认知动词(意识到/发现/感到) | 换外部动作或直接感知;关键情绪节点 ≤2 次/章,其余不让步 |
| 5 | 感官 / X了一下 | 每场景 ≤2 种感官细化;声音线索若是红线关键信息(如枪声=战斗信号)可豁免 |
| 6(最低) | 写作规范 | 其他技法指引,与前 5 级冲突时自动让步 |
几个设计亮点:
- 压缩顺序有明确策略:先砍环境、路人、过渡描写,再动高权重场景的次要元素,情绪拐点段落绝对不碰——保证"压缩不减戏"。
- 二义性边界有示例:比如"声音线索豁免"只适用于简短白描("门开了"三个字),200 字的风声细节描写不算,规则触发条件写得非常具体,避免执行时自由发挥。
- 同级冲突也有裁定:写作规范内部按
文风量化数值 > 作者最新记忆 > 基底铁律 > 题材基线排序。
这套优先级最终会"物化"进提示词的"输出·不可违反规则"列表,writer 读到的顺序本身就是权威顺序。
四、稀疏注入:场景技法最多 2 条,还得"四步转化"
冲突裁定解决"谁说了算",稀疏注入解决"注入多少"。
场景写作方法论(scene-craft)覆盖对话、战斗、环境、心理独白、过渡、群像等类型,每个目录下都有通用方法论 + 题材特化版本(结构见 knowledge/scene-craft/index.md)。如果整段复制进提示词,两个坏处:token 爆炸、writer 被通用模板带偏。所以管线规定:
核心原则:稀疏抽取,禁止全覆盖。每个场景类型只选 1-2 条技法写入提示词,其余技法不出现。
选取不是随机的:先识别本章涉及哪些场景类型 → 按场景核心事件匹配标签(如 [隐瞒]、[权力]、[潜台词])→ 从命中标签的技法里抽 1-2 条。prose(文笔)与 pov(视角)两类始终加载,但每条也只注入 1-2 句精炼指引。
抽出来的技法还不能直接粘贴,必须经过四步转化法,把"通用方法论"变成"这个场景的具体写法":
Step 1 锚定角色 → 套到具体的人(性格、微习惯)
Step 2 锚定信息差 → 谁在瞒、瞒什么、为什么
Step 3 锚定情绪节奏 → 紧张/压抑/舒缓对应不同句式与动作频率
Step 4 融合输出 → 生成可直接写入"输出·写作规范"的指引
对比一下转化前后的差别:
- ❌ 转化前(通用模板):"对话要有动作穿插,每 6-8 句插一个动作。"
- ✅ 转化后(具体写法):"信息差是方岩知道内幕↦陆征不知道。陆征短句逼问、身体前倾;方岩回避,低头喝茶不接话。紧张段快节奏——只有逼问和沉默交替。"
同一条方法论,换一组角色、换一段情绪,写出来的指引完全不同——这是"每章提示词都不一样、角色不会千篇一律"的关键。
五、质检双保险:自检 + 9 维审计
组装完不等于能交付。prompt-crafter 的流程末尾有两道质量门(定义见 agents/prompt-crafter.md):
第一轮:验收自检——逐条检查约 20 项标准,包括:6 元素结构完整、无占位符残留、场景权重已标注(至少 1 个高权重 + 1 个低权重)、技法稀疏(每类型 ≤2 条)、无 meta 泄漏(提示词里不能出现"以下是小说的正文"这类自指短语)、无整段复制章纲。
第二轮:独立审计——切换到"审计者"人格,按 9 个维度验证已写入的提示词(审计 SOP 见 skills/prompt-audit.md):
技法覆盖 / 知识点溯源 / 可执行性 / 四步转化完整性 / 层间一致性 / 去 AI 校验 / 冲突裁定 / 规则去重 / 优先级重排
其中"冲突裁定"和"优先级重排"两个维度,专门核验第三节那张优先级表是否被正确执行。审计 PASS 才能把任务标记 status: DONE,novel-agent 才会把提示词交给 writer;FAIL 则带着问题清单回炉重写。
六、动手跑起来:安装与核心文件地图
安装只需 1 分钟:在 Claude Code / OpenCode / Codex 等工具里直接说"帮我安装 awesome-novel-agent",AI 会自动下载并运行 ./install.sh;手动安装则克隆仓库后执行 ./install.sh <平台>。
想深入阅读源码,这份文件地图可以当导航:
| 内容 | 路径 |
|---|---|
| 6 元素组装完整 SOP(含冲突裁定表、四步转化法) | skills/prompt-crafting.md |
| prompt-crafter agent 定义(运行时配置 + 审计轮) | agents/prompt-crafter.md |
| 9 维 Prompt 独立审计标准 | skills/prompt-audit.md |
| 场景方法论目录(标签选取逻辑) | knowledge/scene-craft/index.md |
| 叙事规则 1-7 唯一权威定义 | knowledge/format-specs/narrative-rules.md |
| 提示词格式规范(6 元素骨架 + 填充规则) | knowledge/format-specs/prompt-setting-style.md |
| 架构总览(管线在整体数据流中的位置) | ARCHITECTURE.md |
七、总结:这套设计给 Prompt 工程的 3 个启示
- 冲突要有"宪法":多材料组装提示词时,先定义全局优先级表(红线 > 字数 > 措辞规则 > 一般规范),并把优先级顺序"物化"到输出的规则列表里,让执行者照单执行而不是临场判断。
- 方法论注入要"稀疏 + 转化":知识库再厚,每类只抽 1-2 条最相关的,再结合角色、信息差、情绪节奏做四步转化——注入的不是"通用知识",而是"本场景的具体写法"。
- 组装与审计分离:自检负责"填没填满",独立审计负责"填得对不对",两个视角分开,质量门才能真正拦下问题。
对于想让 AI 稳定写出长篇小说、又不想正文里全是 AI 味的作者来说,awesome-novel-agent 这条"章纲 → 6 元素提示词 → 正文 → 去 AI 味 → 归档"的完整管线,提供了一个可以直接借鉴的工程化范式。
