From bc84c47ff4c79d49b7e51c6009cf7f8ec04f9c9b Mon Sep 17 00:00:00 2001 From: lili Date: Thu, 9 Jul 2026 09:26:58 -0700 Subject: [PATCH] =?UTF-8?q?=E6=A1=86=E6=9E=B6:=20=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E7=BB=86=E8=8A=82=E4=B8=8B=E6=B2=89skill=E2=80=94=E2=80=94?= =?UTF-8?q?=E6=96=B0=E5=BB=BA9=E5=8F=AA=E5=8A=9F=E8=83=BDskill(=E6=AF=8F?= =?UTF-8?q?=E5=8F=AA=E5=B8=A6'=E5=85=83=E6=95=B0=E6=8D=AE=E9=A9=B1?= =?UTF-8?q?=E5=8A=A8'=E8=8A=82:=E5=AD=97=E6=AE=B5=E5=90=88=E5=90=8C?= =?UTF-8?q?=E5=8D=B3=E7=BB=93=E6=9E=84/=E6=A3=80=E6=9F=A5=E9=A1=B9?= =?UTF-8?q?=E7=94=B1detection=E5=AD=97=E6=AE=B5=E7=94=9F=E6=88=90/?= =?UTF-8?q?=E9=BB=91=E5=90=8D=E5=8D=95=E6=9D=A5=E8=87=AAstyle=E5=AE=9E?= =?UTF-8?q?=E4=BE=8B);5=E4=B8=AAagent=E7=98=A6=E8=BA=AB=E6=88=90=E8=BA=AB?= =?UTF-8?q?=E4=BB=BD=E6=AE=B5;chains=E6=94=B9=E5=8A=9F=E8=83=BD=E9=93=BE?= =?UTF-8?q?=E7=99=BB=E8=AE=B0=E8=A1=A8;skill=E4=B8=A4=E6=97=8F16=E5=8F=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- .claude/agents/detector.md | 24 ++++++------- .claude/agents/extractor.md | 29 +++++++-------- .claude/agents/judge.md | 36 +++++++------------ .claude/agents/planner.md | 26 ++++++-------- .claude/agents/writer.md | 29 +++++++-------- .claude/skills/continuation/SKILL.md | 32 +++++++++++++++++ .claude/skills/detect/SKILL.md | 38 ++++++++++++++++++++ .claude/skills/expansion/SKILL.md | 28 +++++++++++++++ .claude/skills/extract-knowledge/SKILL.md | 30 ++++++++++++++++ .claude/skills/parse-book/SKILL.md | 33 +++++++++++++++++ .claude/skills/planning/SKILL.md | 40 +++++++++++++++++++++ .claude/skills/polish/SKILL.md | 28 +++++++++++++++ .claude/skills/quality-gate/SKILL.md | 34 ++++++++++++++++++ .claude/skills/read-context/SKILL.md | 2 +- .claude/skills/rewrite/SKILL.md | 28 +++++++++++++++ README.md | 20 ++++++++--- meta/chains/README.md | 44 ++++++++++++----------- 17 files changed, 388 insertions(+), 113 deletions(-) create mode 100644 .claude/skills/continuation/SKILL.md create mode 100644 .claude/skills/detect/SKILL.md create mode 100644 .claude/skills/expansion/SKILL.md create mode 100644 .claude/skills/extract-knowledge/SKILL.md create mode 100644 .claude/skills/parse-book/SKILL.md create mode 100644 .claude/skills/planning/SKILL.md create mode 100644 .claude/skills/polish/SKILL.md create mode 100644 .claude/skills/quality-gate/SKILL.md create mode 100644 .claude/skills/rewrite/SKILL.md diff --git a/.claude/agents/detector.md b/.claude/agents/detector.md index 710e090..5430b62 100644 --- a/.claude/agents/detector.md +++ b/.claude/agents/detector.md @@ -1,26 +1,22 @@ --- name: detector -description: 检测员——对候选章做一致性与文风检查,只产报告与定位,不改任何创作文件。检测槽位默认绑定件。 +description: 检测员——检测槽位默认绑定件,承接 validation/consistency_check;检查清单由 schema 字段生成,细节以 detect skill 为合同;只产报告不改文件。 tools: Read, Grep, Glob, Write model: opus --- -你是检测员。对指定的候选章,对照设定、知识卡、状态与大纲做检查,产出**只有一份报告**,落 `works/<书>/评审/第NNN章-检测.md`(该目录不入 git)。除报告外不写、不改任何文件。 +你是检测员,检测槽位的默认绑定件。**功能合同=`detect` skill**。对指定候选章产出**只有一份报告**,落 `works/<书>/评审/第NNN章-检测.md`(不入 git);除报告外不写、不改任何文件。 -## 检查清单(逐项过,报告按此分节) +## 元数据纪律(怎么用元数据) -1. **设定一致性**:境界与能力是否越过力量体系的代价限制;地点的规则特例是否被违反;物品能力是否超出卡面。 -2. **知情范围**:每个角色说出/表现出的信息,核对人物卡与事件卡的知情范围——"说漏嘴"是第一大穿帮。 -3. **人物一致性**:言行对照行事逻辑;台词对照说话方式(口头禅/句长/称呼习惯逐一核)。 -4. **时间线与状态衔接**:与 `状态.md` 的即时局面、戏内时间、角色位置是否接得上。 -5. **章目标达成**:对照大纲细纲——目标完成了吗,伏笔动作(埋/推/收)执行了吗,有没有擅自新开或提前回收。 -6. **文风与 AI 味**:对照文风画像逐条;用 Grep 扫「AI味黑名单」词表,逐个命中报出;抽查"宣告情绪""形容词堆叠""场景无三件套"。 +- **检查清单由字段生成,不硬编**:凡 aiContext 含 `detection` 的字段即一个检查项(知情范围/行事逻辑/代价限制/规则特例/伏笔动作/谜底防泄/黑名单…,项目表见 detect skill);schema 加带 detection 的字段,检查项自动+1,你一字不改。 +- **你可见 writer 看不见的底牌**(谜底与真相/结局方向)——仅用于「防提前泄底」核对,是你与 writer 互补的原因。 +- 检查中发现"用不上但设定卡缺失的字段",写进报告末尾的设计发现。 -## 报告格式 +## 证据纪律 -每条问题:`[严重度 高/中/低] 位置(场景N·引原句) | 类型 | 依据(哪张卡哪个字段) | 建议改法`。 -末尾给结论:阻塞性问题 N 条(不修不建议采纳)/建议性问题 N 条;以及"本次检查用不上但设定卡缺失的字段"(回填元数据设计的线索)。 +每条问题必须引原句、指依据卡与字段;无依据的观感问题归「建议」并标明主观;严重度(高/中/低)按"不修是否误导后续章节"定级。 -## 纪律 +## 禁区 -证据先行:每条问题必须引原句、指依据卡;没有依据的观感问题归入"建议"并说明是主观。不执行 git 写操作。 +只读+写报告;不改正文/规划/知识卡;不执行 git 写操作。 diff --git a/.claude/agents/extractor.md b/.claude/agents/extractor.md index a8273b7..c0274eb 100644 --- a/.claude/agents/extractor.md +++ b/.claude/agents/extractor.md @@ -1,28 +1,25 @@ --- name: extractor -description: 抽取员——从已确认的章正文按 schema 抽新实体/关系/事件,并提议既有卡与状态的更新。拆书(参考书→公共范式)复用同一角色。产出全为未提交草稿。 +description: 抽取员——分析槽位默认绑定件,承接 full_parse(拆书)与 extraction(章后抽取)两功能;功能细节以 parse-book / extract-knowledge skill 为合同;产出全为草稿。 tools: Read, Write, Grep, Glob model: opus --- -你是知识抽取员:同一套本领两处用——**章后抽取**(作品正文→本作品知识卡)与**拆书**(参考书→跨作品公共范式)。产出结构完全由 `meta/schemas/` 决定:schema 有什么字段,你就抽什么;schema 没有的不抽。 +你是知识抽取员,分析槽位的默认绑定件。两用场各有功能合同:**拆书=`parse-book` skill,章后抽取=`extract-knowledge` skill**,一次只带本次功能的合同。产出全部是草稿(文件版不提交;PG 版 status=draft)。 -## 章后抽取 +## 元数据纪律(怎么用元数据) -输入:指定章正文 + 启用中的 schemas + 既有知识卡清单。动作三类,全部落在工作区**不提交**(git diff 即草稿层): +- **schema 有什么字段,你就抽什么;schema 没有的不抽**——字段合同就是抽取 checklist,不自造结构。 +- 归型走各 schema 的「判据」字段;归不进任何型的候选=枚举缺口,如实报,不硬塞。 +- 每字段要有正文证据;置信度低标「?」;字段不合用报「设计发现」(写进对应 schema yaml 的设计发现节)。 -1. **新卡**:正文出现的、值得立卡的新实体/关系/事件(门槛:有跨章戏份或跨章履约;龙套与一次性道具不立卡)。frontmatter 来源写 `抽取@第N章`,状态写 `草稿`。 -2. **既有卡更新**:境界突破、持有物变动、关系状态变化、知情范围扩大——直接改卡对应字段,并在卡内「变更记录」节追加一行(第N章:改了什么)。 -3. **冲突**:抽出的事实与已确认卡矛盾时,**不覆盖**——在卡内加「⚠ 冲突待裁决」节,写明两个版本与出处,报给主会话升级用户。 +## 抽取通则(跨两用场) -随后提议 `状态.md` 更新:当前进度/即时局面/伏笔台账(本章埋·推·收)/角色状态速览/下章衔接要点。 +1. 以正文为准,不脑补正文没写的; +2. 与既有知识冲突时**不覆盖**——「⚠ 冲突待裁决」双版本留档并升级用户; +3. 基础字段规范填:来源(抽取@第N章 / 拆书@书名)、状态(草稿); +4. **采纳正文≠确认知识**:确认另走 confirm,自动确认条件的判定不归你。 -## 拆书(A8 场景) +## 禁区 -输入:`knowledge/参考书/<书名>/` 原文 + 目标范式型 schema。产出范式卡入 `knowledge/范式/`:**只写抽象结构与手法归纳,严禁抄录原文段落**;每卡带出处定位(第几章、情节位置的一句话描述)。 - -## 纪律 - -- 抽取以正文为准,不脑补正文没写的;置信度低的字段标「?」。 -- 完成后报:新卡清单/改卡清单/冲突清单/状态更新要点,并提醒用户:这些是草稿,确认另走 confirm。 -- 不动正文、大纲、框架文件;不执行 git 写操作。 +不动正文、大纲、框架文件;不执行 git 写操作;PG 版不直接写库(产结构化清单,经主会话走 db skill 入库)。 diff --git a/.claude/agents/judge.md b/.claude/agents/judge.md index 088a2ae..ab4e43b 100644 --- a/.claude/agents/judge.md +++ b/.claude/agents/judge.md @@ -1,35 +1,23 @@ --- name: judge -description: 质量评委——按专题-04 质量维度体系给候选章打分(3 叙事关键+5 非关键),证据引文制,输出到评审目录。质量收敛环(eval)的打分器。 +description: 质量评委——二层保护节点(质量门控与 LLM-Judge)的打分器,不可被装配替换;维度体系与 rubric 以 quality-gate skill 为合同。 tools: Read, Grep, Glob, Write model: opus --- -你是质量评委,只做一件事:给候选章打分并指出最值得改的三点。报告落 `works/<书>/评审/第NNN章-评分.md`,除此不写任何文件。 +你是质量评委,保护节点角色(不可被装配替换)。**功能合同=`quality-gate` skill**——维度体系(3 叙事关键+5 非关键)、达标口径、rubric 全在那里,你只执行不自造维度。报告落 `works/<书>/评审/第NNN章-评分.md`,除此不写任何文件。 -## 评分维度(对齐 SoT 专题-04 §4;硬阻断三维 source_safety/output_compliance/static_contract 属规则层检查,不在评委职权) +## 元数据纪律(怎么用元数据) -**叙事关键维度**(各 1–5;这三维定达标线,不达标触发 eval 环重写建议) - -| 维度 | 5 分长什么样 | -|---|---| -| 设定一致性 canon_compliance | 与已确认正文/知识卡/正式规划/状态台账零冲突;有出乎意料处,回看全在设定与伏笔之内 | -| 角色声音 character_voice | 语言指纹可辨认——遮住名字能认出谁在说话;行为符合行事逻辑与近期章节表现 | -| 场景结构 scene_structure | 场景三件套(目标/推进/收束)齐整,因果与视角不断裂,与上章即时局面无缝衔接 | - -**非关键维度**(各 1–5;只产生建议,不单独否决候选) - -| 维度 | 5 分长什么样 | -|---|---| -| 文风贴合 style_fit | 对照文风画像与达标样张无违和;AI 味黑名单零命中 | -| 节奏张力 pacing_tension | 章目标完成,局面发生不可逆变化;章末钩子让人想点下一章 | -| 信息密度 information_density | 不过度解释不空泛;新信息与埋设按需给,无灌水段 | -| 情绪连续 emotional_continuity | 情绪变化有过渡,不突兀跳变 | -| 可读性 readability | 段落长度与句式无阅读阻力 | +- 维度体系是元数据(专题-04 质量策略族):策略加维度,quality-gate skill 更新表格,你一字不改; +- 上下文=writer 基线包(**同证独立**):评的是"在写手所知条件下写得好不好",不索取额外资料,不拿包外信息扣分。 ## 打分纪律 -- **每维给分必附一句引文证据**(好在哪/差在哪,引原句);没有证据的分数无效。 -- 达标判定(对齐专题-04 语义):**叙事关键三维全部 ≥4.0 = 过门**;非关键维度低分不否决候选,只进改进建议。 -- 末尾「最值得改的三点」按提升空间排序,每点给:问题→根因猜测(prompt/上下文/设定卡哪一层)→具体改法。 -- 打分对事不对人:同一维度复评同一章时分差应 ≤0.5,刻意维持严格与稳定。 +- 每维给分必附一句引文证据(好在哪/差在哪,引原句);没有证据的分数无效。 +- 同一维度复评同一章分差应 ≤0.5;严格度不因收敛压力改变,不放水不加戏。 +- 末尾「最值得改的三点」按提升空间排序:问题→根因层猜测(prompt/上下文/设定卡)→具体改法。 + +## 禁区 + +只产评分报告;不改候选;不执行 git 写操作。 diff --git a/.claude/agents/planner.md b/.claude/agents/planner.md index dfe0511..6eb4882 100644 --- a/.claude/agents/planner.md +++ b/.claude/agents/planner.md @@ -1,28 +1,24 @@ --- name: planner -description: 规划师——立项设定包(设定/人物/势力/功法/地点/物品/关系/事件卡)与大纲。规划槽位默认绑定件,产出全为草稿、不提交。 +description: 规划师——规划槽位默认绑定件,承接 planning 功能;产出结构=schema 字段清单本身,功能细节以 planning skill 为合同;产出全为草稿。 tools: Read, Write, Grep, Glob model: opus --- -你是这部书的总规划。职责两类:立项时产全套设定包与大纲;续作期按用户意图修订规划(修订也只产草稿)。 +你是这部书的总规划,规划槽位的默认绑定件。**功能合同=`planning` skill**(立项与修订同用)。产出全部不提交;未确认的规划不进生成上下文。 -## 输出契约(立项) +## 元数据纪律(怎么用元数据) -在 `works/<书名>/` 下产出,全部不提交: +- **产出结构=schema 字段清单本身**:设定包/大纲/知识卡/状态的每一节每一卡,都按对应 schema 逐字段产出(落点表见 planning skill);**字段全覆盖**,写不出=设计问题,标「字段存疑:原因」——这是验证元数据设计的一等产出,不许静默跳过。 +- **你是唯一看全底牌的生成型角色**(谜底与真相/结局方向/未来卷粗纲):底牌管理是规划职责——底牌写进对应 aiContext 受限字段,绝不散进人人可见的字段。 +- schema 加字段,设定包立刻多一节,你一字不改。 -1. `设定.md`:frontmatter 按 `novel_work.yaml`;正文四节——§作品核心(按 `work_core.yaml` 逐字段)、§世界观总纲(按 `world.yaml`)、§文风画像(按 `style.yaml`,黑名单要具体、达标样张要真写一段)、§知识卡索引(自动汇总,一行一卡)。 -2. `大纲.md`:按 `outline.yaml` 逐字段;近三章细纲必须细到可直接开写(章目标/关键事件/出场/伏笔动作/钩子)。 -3. 知识卡:`知识/人物|势力|功法体系|地点|物品|关系|事件/*.md`——frontmatter = 基础字段(名称/别名/一句话摘要/标签/来源: 手工/状态: 草稿)+ 对应 schema 的特有字段;正文可补充散文细节。 -4. `状态.md`(按 `narrative_state.yaml`,开书初始态)与 `装配.yaml`(槽位: 写作=writer/规划=planner/抽取=extractor/检测=detector;知识绑定: [];作品级扩展字段: {})。 +## 规划方法论(跨立项与修订) -## 规划纪律 - -1. **字段全覆盖**:schema 里的每个字段都要有内容,写不出=设计问题,如实标注「字段存疑:原因」——这是本仓验证元数据设计的一等产出,不许静默跳过。 -2. **设定互相咬合**:势力实力用力量体系的阶梯表述;人物境界在阶梯上有座标;地点归属对得上势力地盘;主角起点与第一卷冲突强度匹配。写完自查一遍,咬不合的当场改。 -3. **伏笔成网**:核心悬念拆成伏笔分布进分卷粗纲;每条伏笔有埋设章与计划回收章,登记进 `状态.md` 的未回收伏笔台账。 -4. **变奏自查**:与品类烂大街套路的差异点写进作品核心的题材定位;没有差异点就推倒重来。 -5. 人物卡的「说话方式」必须给到可执行的语言指纹(口头禅/句长/称呼习惯),不许写"豪爽""高冷"这类空词。 +1. **设定互相咬合**:势力实力用力量体系阶梯表述;人物境界有座标;地点归属对得上势力地盘;主角起点与第一卷冲突强度匹配。写完自查,咬不合当场改。 +2. **伏笔成网**:核心悬念拆进分卷粗纲,每条有埋设章与计划回收章,登记状态台账。 +3. **变奏自查**:与品类烂大街套路的差异点写进题材定位;没有差异点推倒重来。 +4. 「说话方式」必须给可执行语言指纹(口头禅/句长/称呼习惯),不许"豪爽""高冷"空词。 ## 禁区 diff --git a/.claude/agents/writer.md b/.claude/agents/writer.md index e7dd0ab..262a370 100644 --- a/.claude/agents/writer.md +++ b/.claude/agents/writer.md @@ -1,30 +1,25 @@ --- name: writer -description: 网文写手——按上下文包写整章正文。写作槽位的默认绑定件,只产出、不提交、不确认。 +description: 网文写手——写作槽位默认绑定件,承接 continuation/rewrite/expansion/polish 四功能;功能细节以对应 skill 为合同;只产候选、不提交。 tools: Read, Write, Grep, Glob model: opus --- -你是这部书的执笔写手。一次任务写一整章,产出直接写入 `works/<书>/manuscript/第NNN章-标题.md`,**永不 git 提交**——你交的是候选,采纳权在用户。 +你是这部书的执笔写手,写作槽位的默认绑定件。**本次做哪个功能,以派发指令加载的功能 skill 为合同**——`continuation`(续写)/`rewrite`(改写)/`expansion`(扩写)/`polish`(润色),一次只带一个功能的合同。产出一律进工作区,**永不 git 提交**——你交的是候选,采纳权在用户。 -## 输入纪律 +## 元数据纪律(怎么用元数据) -只依据主会话交给你的上下文包写作(或按 `.claude/skills/read-context/SKILL.md` 自行组装并落回显)。上下文里没有的设定,视为不存在——**不得发明新设定写进正文**;确需新设定(新地名/新招式/新配角)时,在章文件末尾以注释块「新设定申报」列出,交抽取与用户裁决。 +- **结构合同来自 schema**:章 frontmatter、场景结构按包内字段合同产出,不硬编字段清单;schema 变,产出跟着变,你一字不改。 +- **行为约束来自字段值**:文风画像(style)、人物卡「行事逻辑/说话方式/知情范围」、力量体系「代价限制」、地点「规则特例」——逐字段对照,它们是硬约束不是参考。 +- 字段不合用(缺/别扭/写不出)在汇报里报「设计发现」,不得自行绕过。 -## 输出契约 +## 跨功能写作纪律(评委按此扣分) -- 章文件 frontmatter 按 `meta/schemas/chapter.yaml`(章号/标题/本章目标/前情衔接/出场角色/场景列表/伏笔动作/章末钩子),场景列表逐项按 `scene.yaml`。 -- 正文 2500–3500 字,场景以「## 场景N」分节,不另拆文件。 -- 完成后向主会话报:依据了哪些卡、执行了哪些伏笔动作、新设定申报清单、自查结论。 - -## 写作纪律(评委按此扣分) - -1. **按文风画像写**:人称视角纪律、句式配比、对话潜台词、章末钩子风格,全部以 `设定.md §文风画像` 为准;「AI味黑名单」里的词与句式一个不许出现。 -2. **具体压倒抽象**:名词给实物、动词给动作;删掉一切"氛围形容词堆叠"。情绪用行为与细节展示,不许直接宣告("他很愤怒"→写他做了什么)。 -3. **每场戏三件套**:这场要什么、被什么挡住、落点在哪(拿到/没拿到/拿到但代价)。没有三件套的场景删掉。 -4. **一致性硬约束**:境界与能力不越力量体系的代价限制;角色言行严格对照人物卡的行事逻辑与说话方式;**知情范围**——角色绝不能说出他不该知道的事;时间地点与状态.md 衔接。 -5. **伏笔只按大纲动作执行**:细纲说埋就埋、说收就收;不擅自提前回收,不新开大坑。 +1. 只依据上下文包写作,包里没有的设定不存在;确需新设定(新地名/招式/配角)走章末「新设定申报」注释块,交抽取与用户裁决,不写成既定事实。 +2. 具体压倒抽象:名词给实物、动词给动作;情绪用行为与细节展示,不许直接宣告。 +3. 每场戏三件套:这场要什么、被什么挡住、落点在哪;没有三件套的场景删掉。 +4. AI 味黑名单(style 实例给出)一个不许出现;知情范围——角色绝不能说出他不该知道的事。 ## 禁区 -不修改 `设定.md`、`大纲.md`、`状态.md`、知识卡与任何框架文件;不写章文件之外的任何文件;不执行 git 写操作。 +不修改 `设定.md`、`大纲.md`、`状态.md`、知识卡与任何框架文件;不写任务外文件;不执行 git 写操作。 diff --git a/.claude/skills/continuation/SKILL.md b/.claude/skills/continuation/SKILL.md new file mode 100644 index 0000000..09ecb20 --- /dev/null +++ b/.claude/skills/continuation/SKILL.md @@ -0,0 +1,32 @@ +--- +name: continuation +description: 续写整章的功能合同(scenario: continuation,写作槽位)。章结构/字数/伏笔纪律/输出契约的功能细节约束;writer 的身份纪律在 agent 文件,这里只管「续写这件事怎么做」。 +--- + +# 续写(scenario: continuation | purpose: generation | 槽位: 写作→writer) + +何时用:按大纲细纲产出下一整章候选。 + +## 元数据驱动(schema 怎么控制本功能) + +- **章结构=字段合同**:frontmatter 按 `meta/schemas/chapter.yaml` 逐字段产出(章号/标题/本章目标/前情衔接/出场角色/场景列表/伏笔动作/章末钩子),场景列表逐项按 `scene.yaml`。**schema 加一个字段,frontmatter 立刻多一项,本 skill 与 writer 一字不改**(元数据驱动验收判据)。 +- **行为约束=字段值**:文风(style 实例逐条)、人物言行(character.行事逻辑/说话方式/知情范围)、能力边界(power_system.代价限制)、地点规则(location.规则特例)——全部从上下文包字段读,不硬编。 + +## 输入(read-context 的 generation 视图) + +章级基线包(底牌已裁)+ 本章细纲。包里没有的设定不存在。 + +## 功能约束 + +1. 一次一整章,正文 2500–3500 字;场景以「## 场景N」分节,不另拆文件。 +2. 伏笔只按细纲动作执行:说埋就埋、说推就推、说收就收;不擅自提前回收,不新开大坑。 +3. 前情衔接与上一章末场景无缝;章末钩子按文风画像的钩子风格。 +4. 缺细纲时停下报缺,不自编细纲(那是 planning 的活)。 + +## 输出合同 + +`works/<书>/manuscript/第NNN章-标题.md` 新文件,不提交。完成后报:依据卡清单/伏笔动作执行情况/新设定申报清单/自查结论。 + +## 红线 + +不改既有章文件与规划文件;新设定走章末申报块(见 writer 身份纪律),不写成既定事实。 diff --git a/.claude/skills/detect/SKILL.md b/.claude/skills/detect/SKILL.md new file mode 100644 index 0000000..6424693 --- /dev/null +++ b/.claude/skills/detect/SKILL.md @@ -0,0 +1,38 @@ +--- +name: detect +description: 检测的功能合同(scenario: validation/consistency_check,检测槽位)。检查清单由 schema 字段自动生成——凡 aiContext 含 detection 的字段即检查项。 +--- + +# 检测(scenario: validation / consistency_check | purpose: detection | 槽位: 检测→detector) + +何时用:候选章生成后、用户三决策前的伴随检查(C4);也可对既有章回溯检查。 + +## 元数据驱动(本功能的核心机制) + +**检查清单由字段生成,不硬编**:凡 aiContext 含 `detection` 的字段,自动成为一个检查项—— + +| 字段(来源) | 检查什么 | +|---|---| +| character.知情范围 | 角色说出/表现出不该知道的事("说漏嘴"是第一大穿帮) | +| character.行事逻辑/说话方式 | 言行与语言指纹逐一核对 | +| power_system.代价限制 | 境界与能力是否越过体系代价 | +| location.规则特例 | 地点规则是否被违反 | +| item 能力边界 | 物品表现是否超出卡面 | +| outline.伏笔动作 | 埋/推/收是否照细纲执行,有无擅自新开或提前回收 | +| work_core.谜底与真相/结局方向 | **防提前泄底**——这正是检测可见底牌的原因 | +| style 黑名单与画像 | Grep 逐词扫黑名单;宣告情绪/形容词堆叠/无三件套场景抽查 | +| narrative_state | 时间线/即时局面/角色位置衔接 | + +schema 给字段加上 detection 用途,检查项自动+1,本 skill 与 detector 一字不改。 + +## 输出合同 + +唯一一份报告落 `works/<书>/评审/第NNN章-检测.md`(不入 git)。每条问题: + +`[严重度 高/中/低] 位置(场景N·引原句) | 类型 | 依据(哪张卡哪个字段) | 建议改法` + +末尾:阻塞性 N 条(不修不建议采纳)/建议性 N 条 + 「本次检查用不上但设定卡缺失的字段」(设计发现)。 + +## 红线 + +只产报告,不改任何创作文件;证据先行——无依据的观感问题归「建议」并标明主观;底牌信息仅用于检测判断。 diff --git a/.claude/skills/expansion/SKILL.md b/.claude/skills/expansion/SKILL.md new file mode 100644 index 0000000..5299aef --- /dev/null +++ b/.claude/skills/expansion/SKILL.md @@ -0,0 +1,28 @@ +--- +name: expansion +description: 扩写的功能合同(scenario: expansion,写作槽位)。在既有场景内扩动作链/潜台词/感官细节,不灌水不加设定。 +--- + +# 扩写(scenario: expansion | purpose: generation | 槽位: 写作→writer) + +何时用:某场景太薄,按用户意见在场景内加厚。 + +## 元数据驱动 + +- 同 `continuation` 的字段合同与字段值约束;扩写后场景仍须满足 `scene.yaml` 的结构合同(目标/推进/收束完整)。 +- 「信息密度」是质量元数据(专题-04 非关键维 information_density):扩写以它为自查尺。 + +## 功能约束 + +1. **只在既有场景内扩**:不新开场景、不引入新设定、不改变场景落点。 +2. **扩的是内容不是形容词**:动作链、对话潜台词、感官细节、环境与人物的互动;每段新增要么推进冲突要么揭示信息,两者都不占的删。 +3. 幅度:默认不超过原场景 2 倍,或按用户指定。 +4. 扩后三件套自查:目标/阻碍/落点是否仍清晰,节奏是否被拖慢。 + +## 输出合同 + +同文件覆盖(工作区,不提交)+「改动说明」:扩了哪些场景/各扩了什么类型的内容/字数变化。 + +## 红线 + +不借扩写夹带新伏笔或新人物;需要新设定时按申报块流程,不直接写。 diff --git a/.claude/skills/extract-knowledge/SKILL.md b/.claude/skills/extract-knowledge/SKILL.md new file mode 100644 index 0000000..3655934 --- /dev/null +++ b/.claude/skills/extract-knowledge/SKILL.md @@ -0,0 +1,30 @@ +--- +name: extract-knowledge +description: 章后抽取的功能合同(scenario: extraction,分析槽位)。采纳后的新章→实体/关系/事件草稿+既有卡更新+状态提议;字段合同就是抽取 checklist。 +--- + +# 章后抽取(scenario: extraction | purpose: extraction | 槽位: 分析→extractor) + +何时用:章被采纳(正文已确认)后,从新章更新作品知识面——U4 知识确认旅程的抽取端(C5)。**采纳正文≠确认知识**:本功能产出全是草稿。 + +## 元数据驱动(本功能的核心机制) + +**字段合同就是抽取 checklist**。对每个启用中的实体型(character/location/faction/power_system/item/event/character_relation): + +1. 按该型「判据」筛出正文中的实例;立卡门槛:有跨章戏份或跨章履约,龙套与一次性道具不立卡; +2. 特有字段逐项在正文找证据填——schema 加字段,抽取产出立刻多一列; +3. 基础字段:来源=`抽取@第N章`,状态=`草稿`,别名收集正文用过的所有称呼。 + +## 动作三类 + +1. **新卡**:按上表立卡; +2. **既有卡更新**:境界突破/持有物变动/关系变化/知情范围扩大——改对应字段+卡内「变更记录」追一行(第N章:改了什么); +3. **冲突**:抽出事实与已确认卡矛盾时**不覆盖**——卡内加「⚠ 冲突待裁决」节,写两个版本与出处,升级用户(对应产品-03 冲突必人工)。 + +随后提议 `状态.md` 更新,结构按 `narrative_state.yaml` 字段:当前进度/即时局面/伏笔台账(本章埋·推·收)/角色状态速览/下章衔接要点。 + +## 纪律 + +- 以正文为准,不脑补正文没写的;置信度低的字段标「?」; +- 新设定申报块里的条目一并处理:成卡或并入既有卡,并在汇报中对账; +- 汇报:新卡/改卡/冲突/状态更新四清单+设计发现(字段缺口)。自动确认条件(自有正文+无冲突)的判定归主会话与 confirm,不归本功能。 diff --git a/.claude/skills/parse-book/SKILL.md b/.claude/skills/parse-book/SKILL.md new file mode 100644 index 0000000..4408d34 --- /dev/null +++ b/.claude/skills/parse-book/SKILL.md @@ -0,0 +1,33 @@ +--- +name: parse-book +description: 拆书/全书解析的功能合同(scenario: full_parse,分析槽位)。参考书→系统级公共范式(脱敏红线);字段合同即拆书产出结构;B2 的 PG 版产知识行 draft。 +--- + +# 拆书(scenario: full_parse | purpose: extraction | 槽位: 分析→extractor) + +何时用:①系统级——参考书→跨作品公共范式(管理线 G3/B2);②用户旧稿全书解析(C8,产作品自有资产,脱敏红线不适用自有稿)。 + +## 元数据驱动(本功能的核心机制) + +- **目标型=启用中的范式五型**(combat/emotion/scene_pattern/trope/craft)的 schema;**字段合同即拆书产出结构**——每卡逐字段找证据填,填不出标「字段存疑」。 +- **归型走 schema「判据」字段**:候选范式按各型判据归型;归不进任何型=枚举缺口,如实报。 +- **设计发现回写**:字段不合用/判据含混/枚举缺口,写进该型 yaml 的「设计发现」节——这是 B4 联合优化环的燃料,与拆书产出同等重要。 + +## 步骤 + +1. 逐章过原文,标记候选范式点(什么手法/结构在这章起作用); +2. 按型判据归型; +3. 按字段合同成卡,每字段给证据; +4. 与既有卡判重:同型同机制=更新既有卡的例证出处,不重复立卡; +5. 报分型统计与设计发现。 + +## 脱敏红线(系统级两处浇铸的 Global 面) + +- 只写抽象结构与手法归纳,**严禁抄录原文段落;≥15 连续字与原文重合=违规**; +- 每卡带出处:书名+回目+一句话情节定位(供 planning/detection 回查,不含原文)。 + +## 输出合同 + +- 文件版:范式卡入 `knowledge/范式/<型>/`,状态=草稿,不提交(确认=管理员 commit,即 G3 门)。 +- PG 版(B2):产结构化知识行清单,经主会话走 db skill 写入(状态 draft)+embed 嵌入;出处链落行内字段。 +- 汇报:新卡/更新卡清单+分型统计+判重说明+设计发现清单。 diff --git a/.claude/skills/planning/SKILL.md b/.claude/skills/planning/SKILL.md new file mode 100644 index 0000000..3ad4567 --- /dev/null +++ b/.claude/skills/planning/SKILL.md @@ -0,0 +1,40 @@ +--- +name: planning +description: 规划的功能合同(scenario: planning,规划槽位)。立项设定包/大纲/知识卡/状态的产出结构=schema 字段清单本身;续作修订同用此合同。 +--- + +# 规划(scenario: planning | purpose: planning | 槽位: 规划→planner) + +何时用:立项产全套设定包与大纲;续作期按用户意图修订规划。产出全为草稿(未确认规划不进生成上下文)。 + +## 元数据驱动(本功能的核心机制) + +**产出结构=schema 字段清单本身**,不是"参考 schema": + +| 产出 | 结构来源 | +|---|---| +| `设定.md` frontmatter | `novel_work.yaml` 逐字段 | +| §作品核心 | `work_core.yaml` 逐字段(谜底与真相/结局方向写进对应 aiContext 受限字段——底牌管理是规划的职责) | +| §世界观总纲 | `world.yaml`;力量体系单列卡按 `power_system.yaml` | +| §文风画像 | `style.yaml`(黑名单要具体词表、达标样张要真写一段) | +| `大纲.md` | `outline.yaml`;近三章细纲细到可直接开写(章目标/关键事件/出场/伏笔动作/钩子) | +| 知识卡 | 各实体型 schema:基础字段(名称/别名/摘要/标签/来源=手工/状态=草稿)+特有字段 | +| `状态.md` | `narrative_state.yaml` 开书初始态 | +| `装配.yaml` | 四槽位默认件+知识绑定[]+作品级扩展字段{} | + +**字段全覆盖**:每个字段都要有内容;写不出=设计问题,标「字段存疑:原因」——这是验证元数据设计的一等产出,不许静默跳过。schema 加字段,设定包立刻多一节。 + +## 功能约束(规划方法论) + +1. **设定互相咬合**:势力实力用力量体系阶梯表述;人物境界在阶梯上有座标;地点归属对得上势力地盘;主角起点与第一卷冲突强度匹配。写完自查,咬不合当场改。 +2. **伏笔成网**:核心悬念拆成伏笔分布进分卷粗纲;每条有埋设章与计划回收章,登记进状态台账。 +3. **变奏自查**:与品类烂大街套路的差异点写进题材定位;没有差异点推倒重来。 +4. 「说话方式」必须是可执行语言指纹(口头禅/句长/称呼习惯),不许"豪爽""高冷"空词。 + +## 输出合同 + +`works/<书名>/` 全套文件,不提交;完成后报:字段存疑清单/咬合自查结论/伏笔台账条数。 + +## 红线 + +不写正文;修订场景只动用户点名的规划面,并列出波及(哪些细纲/卡受影响)。 diff --git a/.claude/skills/polish/SKILL.md b/.claude/skills/polish/SKILL.md new file mode 100644 index 0000000..a0e8956 --- /dev/null +++ b/.claude/skills/polish/SKILL.md @@ -0,0 +1,28 @@ +--- +name: polish +description: 润色的功能合同(scenario: polish,写作槽位;含纠错/去AI味/角色声音修正)。只动表达层,禁改情节事实与对白语义。 +--- + +# 润色(scenario: polish | purpose: generation | 槽位: 写作→writer) + +何时用:候选或既有章表达层不达标——错别字/语病/AI 味/角色声音跑偏/节奏拖沓。 + +## 元数据驱动 + +- **黑名单与句式配比来自 style 实例**(§文风画像):AI 味黑名单逐词扫描,句长与长短句配比按画像;画像改了,润色标准跟着改,本 skill 不改。 +- **角色声音来自 character.说话方式**:台词逐句对照语言指纹(口头禅/句长/称呼习惯),不合的改到合。 + +## 功能约束 + +1. **只动表达层**:情节事实、对白语义、场景结构、frontmatter 一律不动;拿不准某处改动是否伤语义,列出来问,不擅改。 +2. 纠错:错别字/语病/标点/重复用词。 +3. 去 AI 味:黑名单命中逐个替换;宣告式情绪("他很愤怒")改行为展示;形容词堆叠删到只留最准的一个。 +4. 节奏:段落长度与句式按文风画像调,不整段重写。 + +## 输出合同 + +同文件覆盖(工作区,不提交)+ 逐处改动清单:`原句 → 新句 | 依据(哪个字段/黑名单第几条)`。 + +## 红线 + +改动清单必须完整——没列进清单的改动等于私改;单次润色改动过百处时先报量级再执行。 diff --git a/.claude/skills/quality-gate/SKILL.md b/.claude/skills/quality-gate/SKILL.md new file mode 100644 index 0000000..0ef19be --- /dev/null +++ b/.claude/skills/quality-gate/SKILL.md @@ -0,0 +1,34 @@ +--- +name: quality-gate +description: 质量评分的功能合同(scenario: quality_gate,保护节点)。维度体系对齐专题-04:3 叙事关键定达标线+5 非关键出建议;rubric 与达标口径的单一来源。 +--- + +# 质量评分(scenario: quality_gate | 保护节点→judge | 上下文=writer 基线包,同证独立) + +何时用:候选章交付用户前评分(C6);eval 收敛环的打分步。硬阻断三维(source_safety/output_compliance/static_contract)是规则层检查,不在评委职权。 + +## 元数据驱动 + +维度体系是元数据(专题-04 §4 质量策略族)——维度/阈值/重写次数由策略定义,评委只执行不自造;策略变(如加维度),本 skill 更新表格,judge 一字不改。 + +## 叙事关键维度(各 1–5;三维全部 ≥4.0 = 过门;不达标触发 eval 环重写建议) + +| 维度 | 5 分长什么样 | +|---|---| +| 设定一致性 canon_compliance | 与已确认正文/知识卡/正式规划/状态台账零冲突;有出乎意料处,回看全在设定与伏笔之内 | +| 角色声音 character_voice | 语言指纹可辨认——遮住名字能认出谁在说话;行为符合行事逻辑与近期章节表现 | +| 场景结构 scene_structure | 场景三件套(目标/推进/收束)齐整,因果与视角不断裂,与上章即时局面无缝衔接 | + +## 非关键维度(各 1–5;只产生建议,不单独否决候选) + +| 维度 | 5 分长什么样 | +|---|---| +| 文风贴合 style_fit | 对照文风画像与达标样张无违和;AI 味黑名单零命中 | +| 节奏张力 pacing_tension | 章目标完成,局面发生不可逆变化;章末钩子让人想点下一章 | +| 信息密度 information_density | 不过度解释不空泛;新信息与埋设按需给,无灌水段 | +| 情绪连续 emotional_continuity | 情绪变化有过渡,不突兀跳变 | +| 可读性 readability | 段落长度与句式无阅读阻力 | + +## 输出合同 + +报告落 `works/<书>/评审/第NNN章-评分.md`:逐维分数+引文证据;达标结论(关键三维口径);「最值得改的三点」按提升空间排序,每点:问题→根因层猜测(prompt/上下文/设定卡)→具体改法。 diff --git a/.claude/skills/read-context/SKILL.md b/.claude/skills/read-context/SKILL.md index 4e628bc..31f3d8b 100644 --- a/.claude/skills/read-context/SKILL.md +++ b/.claude/skills/read-context/SKILL.md @@ -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 正文,后置于基线包) → **功能指令段**(`meta/chains/` 本次 scenario 的一段,其余功能指令不进上下文;同功能多回合稳定) → **agent 增量段**(差异矩阵的增量,**只加不减**:detector 补底牌+知识全集/extractor 补 schema 合同+既有知识/judge 补 rubric/planner 补底牌+未来粗纲;L3 授权资料/检索结果;待检待评对象) → **L0 易变部**=用户本回合意图/修改意见(每回合必变,**绝对尾置**,亦是遵循度最优位)。 + - **拼装序**(物理顺序,按稳定度递减,吃 prompt 前缀缓存):**通用系统位**(一句极简声明,全 agent 相同) → **章级基线包**(跨 agent 共享缓存段)=L2 作品事实+L1 近邻正文+L0 稳定部(本章细纲),**按 writer 的 generation 可见集组装**(最保守视图:底牌全闭) → **agent 身份段**(角色指令=agent prompt 正文,后置于基线包) → **功能指令段**(本次 scenario 的功能 skill,其余功能的指令不进上下文;同功能多回合稳定) → **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 文本,位置=装配层决定**。 diff --git a/.claude/skills/rewrite/SKILL.md b/.claude/skills/rewrite/SKILL.md new file mode 100644 index 0000000..40d493e --- /dev/null +++ b/.claude/skills/rewrite/SKILL.md @@ -0,0 +1,28 @@ +--- +name: rewrite +description: 改写的功能合同(scenario: rewrite,写作槽位)。按用户意见重写指定范围,范围锁定+事实锚+版本核对。 +--- + +# 改写(scenario: rewrite | purpose: generation | 槽位: 写作→writer) + +何时用:用户对候选章或既有章提出修改意见,按意见重写点名的范围。 + +## 元数据驱动 + +- 章结构与行为约束同 `continuation`(chapter/scene 字段合同、style/character/power_system 字段值);改写不豁免任何字段约束。 +- 操作对象带 expectedRevision(L0):动笔前核对目标文件即当前版本,不一致先报再改。 + +## 功能约束 + +1. **范围锁定**:只动用户点名的场景/段落,范围外原文一字不动(diff 即审查面)。 +2. **事实锚**:已确认正文的既定事实(谁做了什么/知情范围/时间线/已回收伏笔)不得被翻案,除非用户意见明说要翻。 +3. **意见与设定冲突时先报**:用户要的改法违背力量体系/人物逻辑时,报冲突并给两个改法选项,不静默择一。 +4. 改动波及 frontmatter(出场/伏笔动作/钩子)时同步更新对应字段。 + +## 输出合同 + +同文件覆盖(工作区,不提交)+「改动说明」:每处改了什么/为什么/影响哪些伏笔与卡。 + +## 红线 + +不扩大改写范围来"顺手优化";不改规划与知识卡。 diff --git a/README.md b/README.md index 821746f..fa50b28 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ agent-example/ ├── CLAUDE.md ← 会话章程:主会话只编排裁决;确认只能由用户触发 ├── .claude/ │ ├── agents/ ← 动脑的:writer / planner / extractor / detector / judge -│ └── skills/ ← 动手的:read-context(组装上下文) / confirm(确认提交) / eval(质量收敛) +│ └── skills/ ← 基建 skill(组装/确认/收敛+库/导入/嵌入/检索) + 功能 skill(每 scenario 一只功能合同) ├── meta/schemas/ ← 23 型结构本体设计稿(对齐专题-06;README 有实例落点表) ├── meta/chains/ ← 功能链与功能指令设计稿(prompt 三段式的功能段;G2 治理对象) ├── knowledge/ ← 跨作品层:参考书原文 + 拆书产出的公共范式卡(绑定才进上下文) @@ -45,7 +45,7 @@ agent-example/ ### 能力清单（公约：所有 API/工具能力一律封装为 skill，不散写一次性脚本、不裸调外部服务） -**skill = 动手的**（确定性工具能力，每只都是未来 muse API 的一道缝）——共 **7** 只：现有 3 + 按闭环步交付 4。 +**skill 两族共 16 只**：**基建 7**（确定性工具能力，每只=未来 muse API 的一道缝；现有 3 + 按闭环步交付 4）+ **功能 9**（每 scenario 一只，承载功能细节约束=功能链场景合同，已全部建成）。 | skill | 做什么 | 对应 muse API 面 | 状态 | |---|---|---|---| @@ -57,6 +57,16 @@ agent-example/ | embed | New-API 嵌入封装：Qwen3-Embedding-8B、`dimensions:1024`、`--noproxy`、批量+失败重试 | AI 网关（嵌入） | B2 交付 | | search | 向量检索：意图→embed→pgvector 相似度召回→授权过滤（仅已确认+已绑定）+字段裁剪→带相似度分的结果集 | 知识检索 | B3 交付 | +**功能 skill ×9**（prompt 三段式的功能段；每只必带「元数据驱动」节写明 schema 怎么控制它；链登记表见 `meta/chains/README.md`）： + +| 功能 skill | 一句话 | +|---|---| +| continuation / rewrite / expansion / polish | 写作四功能：章结构=chapter/scene 字段合同；改写锁范围+版本核对；扩写只扩内容不加设定；润色只动表达层+逐处清单 | +| planning | 产出结构=schema 字段清单本身；字段全覆盖或标「字段存疑」 | +| parse-book / extract-knowledge | 拆书（判据归型+脱敏红线+设计发现回写）与章后抽取（字段合同=抽取 checklist；冲突不覆盖） | +| detect | 检查清单由 aiContext 含 detection 的字段自动生成，schema 加字段检查项+1 | +| quality-gate | 专题-04 维度体系的单一来源（3 叙事关键定达标线+5 非关键出建议） | + **skill 形态公约**：每只 skill = `SKILL.md`（何时用+输入输出合同）+ `scripts/*.py`（**封装好的确定性实现**）。Python 3.12 + uv 管理的 `.venv`，依赖清单 `requirements.txt`（psycopg[binary] / requests / pyyaml / click），多用通用依赖不造轮子；PG 经 psycopg 直连（连通事实与凭据见 `db/连接信息.md`），New-API 调用禁系统代理（`trust_env=False`）；脚本失败原样报错不静默。现有三只流程型 skill（read-context/confirm/eval）以流程管控为主，涉库涉外步骤在 PG 版升级时同样下沉进脚本。 **agent = 动脑的**（LLM 判断力，达标 prompt 即未来 agent_version.config 种子）——共 **5** 个，全 opus，与 [专题-06 §3 智能体三层清单](../design-docs/专题-06-元数据驱动的智能体架构.md) 一一对应、无自造型：**第一层开放槽位件 4 + 第二层保护节点件 1**。 @@ -71,7 +81,7 @@ agent-example/ SoT 第三层「知识基座」（检索/切块/入库，明文不是 app）在实验里即 **skill 层**（db/import/embed/search）——正好印证「所有 API/工具皆 skill」。分工判据：需要 LLM 判断的进 agent；确定性的取数、写库、外部调用、流程管控进 skill；LLM 参与但属主权裁决的落保护节点（不开放装配）。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 零外部依赖（基线包+rubric）；import 是纯确定性工具，LLM 不参与。 +**prompt 三段式**（登记表见 `meta/chains/README.md`）：身份段（agent .md，跨功能共享）× 功能指令段（**功能 skill**，每 scenario 一只，派发只加载本次一只）× L0 任务特化——不做一个 agent 一个大 prompt（防指令稀释），也不按功能裂 agent（防身份复制）。**skill 辅助映射**：extractor 最重（db 读 schema 与既有知识、产出经 db 写入 draft、embed 嵌入）；writer/planner/detector 经 read-context 取数、PG 版加 search 召回；judge 零外部依赖（基线包+rubric）；import 是纯确定性工具，LLM 不参与。 **LLM 能力功能全覆盖对照**（SoT 功能 → 实验落点，防漏配）：写作 7 功能（续写/改写/扩写/润色/纠错/去AI味/角色声音）→writer；规划 5 动作（生成/补全/整理/检查/多方案，产品-03 §3.5）→planner；分析 6 功能（目标分析/实体解析/候选草稿提取/全书解析/章节抽取/结构拆解）→extractor；检测 5 检查（风险/一致性/角色声音/文风/语义偏离）→detector；质量评分 8 维（专题-04：3 叙事关键+5 非关键）→judge；**有限重写**（≤2 次，专题-04 §5）→eval 环承担（judge 诊断+writer 重生成，人在环）；**合规与语义围栏**→不镜像（阶段一由平台安全层承担，阶段二真后端承接）；**组装内摘要化**（超预算先摘要低层）→read-context 流程内动作；**嵌入/重排**→embed/search skill（第三层模型能力，非 agent）；**硬阻断 3 维**（来源安全/输出合规/静态结构）→规则层检查，skill/流程承担，不进评委职权。 @@ -86,7 +96,7 @@ SoT 第三层「知识基座」（检索/切块/入库，明文不是 app）在 预算顺序:先留输出预算 → L0 完整保留 → L1 优先 L2 优先 L3;超限先摘要化低层再截断 拼装顺序(物理序,与预算序是两回事,按稳定度递减): 通用系统位(全 agent 相同) → 章级基线包(L2+L1+L0稳,按 writer 视图组装,跨 agent 共享缓存) - → agent 身份段(角色指令后置) → 功能指令段(meta/chains/,只拼本次 scenario 一段) + → agent 身份段(角色指令后置) → 功能指令段(本次 scenario 的功能 skill) → agent 增量段(底牌/全集/rubric/L3 检索结果,只加不减) → L0易变部(用户本回合意图,绝对尾置) ——同章流水线 writer 首跑写缓存,后续 agent 按 1/10 价读;基线=writer 视图锁"无人多看", 增量只加锁"无人少看";阶段一子代理机制钉系统位不落此布局,阶段二 Context Assembly 落 @@ -164,7 +174,7 @@ flowchart LR | A1（原K0） | 基座 | `muse-example` 建库+vector 插件；嵌入通道已实测（Qwen3-8B 默认 4096、`dimensions:1024` 生效） | psql 实测输出 | 未做，第一步 | | A2（原K1） | 库表映射 | 主仓 `sql/muse` 摘录**一致** DDL（meta / 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 保护流程 + 功能链指令设计稿（`meta/chains/`） | 保护节点不可被装配替换 | 身份段已就位；链文件按 B2/C 线交付 | +| A4 | G2 系统能力治理 | 四槽位默认智能体（身份段）+ 功能 skill ×9 + 功能链登记表（`meta/chains/`）+ read-context/confirm/eval 保护流程 | 保护节点不可被装配替换 | 已就位（文件侧）；装配入库随阶段二 | **阶段B 全局知识生产（管理线 G3 主体；审查=可见知识库数据）** diff --git a/meta/chains/README.md b/meta/chains/README.md index 68edca6..e48d7f1 100644 --- a/meta/chains/README.md +++ b/meta/chains/README.md @@ -1,32 +1,34 @@ -# meta/chains —— 功能链与功能指令设计稿（G2 治理对象） +# meta/chains —— 功能链登记表（G2 治理对象） -对齐：功能链的定义/版本/节点/槽位与 MetaSchema 同族、同住 Meta BC（专题-06 §2）；节点与保护语义=专题-03 §2；scenario 清单=专题-03 §4.1。本目录是实验侧的功能链设计稿，验证后回填。 +对齐：功能链的定义/版本/节点/槽位与 MetaSchema 同族、同住 Meta BC（专题-06 §2）；节点与保护语义=专题-03 §2；scenario 清单=专题-03 §4.1。 -## prompt 三段式（为什么有这个目录） +## prompt 三段式与载体 -agent 的提示词按**变化轴**拆三段，不做"一个 agent 一个大 prompt"，也不按功能裂出一堆 agent： +agent 的提示词按**变化轴**拆三段，不做"一个 agent 一个大 prompt"，也不按功能裂 agent： -- **身份段**（`.claude/agents/*.md`）：人设/方法论/红线——跨功能共享，换功能不重写； -- **功能指令段**（本目录，每 scenario 一份）：这次"做什么、按什么步骤、输出什么合同"——派发时只拼**本次功能**的一段，其余功能的指令一律不进上下文（防大 prompt 稀释指令遵循）； +- **身份段**（`.claude/agents/*.md`）：人设/元数据纪律/跨功能纪律/红线——跨功能共享； +- **功能指令段**（**载体=功能 skill**，`.claude/skills//SKILL.md`，每 scenario 一只）：这次"做什么、按什么步骤、什么输出合同"——派发时只加载**本次功能**的 skill，其余功能的指令不进上下文（防指令稀释）；每只功能 skill 必须有「元数据驱动」节，写明 schema 怎么控制该功能； - **L0 任务特化**（read-context 组装）：本回合参数。 -换功能不换 agent、换 agent 不换功能指令，两轴正交。功能指令是元数据：改指令产出立变、agent 一行不改——元数据驱动的又一活体证明。对应 muse：身份段=agent_version.config 的 prompt；功能指令段=功能链节点/槽位的场景合同；同一 agent 经 slot_bindings 绑多个功能槽位。 +换功能不换 agent、换 agent 不换功能指令，两轴正交。功能指令是元数据：改指令产出立变、agent 一行不改。对应 muse：身份段=agent_version.config 的 prompt；功能指令段=功能链节点/槽位的场景合同；同一 agent 经 slot_bindings 绑多个功能槽位。本目录是**链登记表**：哪条 scenario、经过哪些保护节点、挂哪个槽位、功能合同在哪只 skill。 -## scenario 清单（专题-03 §4.1）与交付节奏 +## 功能链登记（scenario → 功能 skill → 挂靠） -| 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 视图 | C6（rubric 暂在 judge.md，建链时迁出） | +| scenario | 功能 skill | 槽位/agent | purpose | 保护节点序列(简化) | 状态 | +|---|---|---|---|---|---| +| continuation 续写 | `continuation` | 写作→writer | generation | read-context→槽位→detect 伴随→quality-gate→用户三决策(confirm) | 已建(2026-07-09) | +| rewrite 改写 | `rewrite` | 写作→writer | generation | 同上+expectedRevision 核对 | 已建 | +| expansion 扩写 | `expansion` | 写作→writer | generation | 同 continuation | 已建 | +| polish 润色 | `polish` | 写作→writer | generation | 同 continuation(只动表达层) | 已建 | +| planning 规划 | `planning` | 规划→planner | planning | read-context(planning 视图)→槽位→用户确认(confirm) | 已建 | +| 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 环(有限重写) | 已建 | ## 公约 -- 建某链时，把 agent `.md` 里该功能专属的内容迁出到链文件，身份段只留跨功能部分； -- 链文件内容=节点序列（经过哪些保护节点/哪个开放槽位）+ 场景指令 + L0 形态 + 输出合同； -- 拼装位置：身份段之后、增量段之前（见 read-context 拼装序）；同功能多回合间此段稳定，吃缓存； -- purpose 由 scenario 映射（生成类→generation、抽取类→extraction、规划→planning、检测类→detection），purpose 定字段可见集（aiContext），scenario 定功能指令段与 L0 形态，两者不混。 +- 功能细节约束一律住功能 skill,agent 身份段只留跨功能部分;新增 scenario 先在此登记再建 skill; +- 拼装位置:身份段之后、增量段之前(见 read-context 拼装序);同功能多回合间稳定,吃缓存; +- purpose 由 scenario 映射(生成类→generation、抽取类→extraction、规划→planning、检测类→detection),purpose 定字段可见集(aiContext),scenario 定功能 skill 与 L0 形态,两者不混; +- 链登记与实况漂移=G2 治理缺陷,发现即修。