zizi-al/muse-agent-example

Fork 0

zizi 1c05b8df7b 框架: 收敛 Agent 证据链并迁移生产写作入口

2026-08-22 16:07:07 +08:00

45 KiB

Raw Blame History

创作周期与 Skill 导读

这篇是教学地图，方便在编辑器里点目录、点链接往下读。它不是合同权威。阶段顺序、门禁、人机分界以 05-创作流程领域为准；某只 Skill 此刻允许做什么，以对应 SKILL.md 为准。两边若有出入，以那两处为准，回改本文。

磁盘上现有 58 只 Skill（skills.json 与 .agent/skills/ 一致）。分类索引进度可能滞后，以 58 为准。

怎么用这份文档

建议按这个顺序读，不必一次读完：

先记住三件事
一次任务怎么加载 Skill
两条时钟
从沿周期走挑你现在关心的那一段
某只 Skill 想看细节：点卡片里的 SKILL.md；方法类再进同目录 references/

编辑器里用大纲/目录面板跳章节。每个 Skill 名都链到仓库里的合同原文。

先记住三件事

1. 分类不是加载

Skill 分类索引回答：这只 Skill 主用在创作周期哪一段。

功能链登记回答：这一回合角色 prompt 里真正塞进哪一份合同。

一次派发只带一只功能 Skill。其余功能合同不进这次上下文。

2. 角色文件不写「这次做什么」

五种角色身份在 .agent/agents/：planner / writer / extractor / detector / judge；稳定合同集中在角色合同，角色文件只写短身份提示。

这次做什么、按什么步骤、输出什么，写在功能 Skill 里。换功能不换角色；换角色不换功能指令。

3. 人盯的是「创作内容变没变」

可自动	必须你在场
只读检查、装载方法、机械/语义门、诊断报告、运行证据	生成或改草稿与正文、确认卡、激活规则、把候选写进正式库

正式内容的权威是 PostgreSQL（库名 muse-example）。Git 管代码、Skill、文档和 DDL，不管「系统里有没有这章正文」。

两个词当场说清：

Shadow：待审草稿，可预览，还不是正式事实。
Canonical：库里的正式正文 / 已确认规划 / 已转正知识。

系统里的五种角色

角色	文件	默认接哪些功能	产出
规划师 planner	planner.md	设定初始化、书级规划、章级细纲	全是草稿
写手 writer	writer.md	续写、改写、扩写、润色	只回候选正文，不写文件、不提交
抽取员 extractor	extractor.md	拆书、章后抽卡	全是草稿
检测员 detector	detector.md	语义一致性检查	只出检测报告，不改候选
评委 judge	judge.md	按量表匿名打分	只评分，不裁决过不过

主会话负责选 Skill、冻上下文、跑机械门、请你决策。它不能代替这些角色创作，也不能跳过保护步骤。

写手有一条跨功能纪律，每次续写都在：具体压倒抽象；每场戏要有「要什么 / 被什么挡 / 落点」；文风黑名单里的词不许出现；角色不能说出他不该知道的事。

一次任务怎么加载 Skill

提示词拆成四段，不做成「一个角色一份大 prompt」：

身份段       ← .agent/agents/*.md             Agent-facing 身份、Skill 路由和工具提示
角色合同段   ← architecture/角色合同.md       稳定边界、模型策略和失败规则
功能指令段   ← 一只功能 Skill 的 SKILL.md      由 scenario 决定
L0 任务段    ← assemble-context 组装          本回合参数

scenario 是这条功能链的名字，例如续写 continuation、细纲 fine_outline。它映射到哪只 Skill，看 meta/chains/README.md。

三次装载，互不替代：

方式	谁决定	进不进角色 prompt
功能指令	当前 scenario → 一只功能 Skill	进。一次一只
编排调用	主会话按节点「必用 / 可选 / 等人授权」	不一定进角色；常是主会话跑脚本
模型自路由	`invocation = model_routed` 的方法 Skill，模型读 `name` + `description` 决定用不用	可能进，但是方法参考，不是功能合同

Skill 还有两个实现形态：

形态	做什么	典型位置
系统能力	执行动作，产生落库事实	`SKILL.md` + `scripts/`
参照 / 方法	教角色怎么判断，不写 Canonical	`SKILL.md` 的方法索引 + `references/`

方法 Skill 不进功能链登记。目标是在规划节点和正文节点自动装载、只出检查报告；按报告改内容仍要你点头。自动检查这一层尚未建成。

调用开关（写在 skills.json）：

orchestrated：必须主会话或上游显式调用。frontmatter 带 disable-model-invocation: true。模型自己喊没有用。
model_routed：模型可以按描述自行选用。方法 Skill 大多是这种。

两条时钟

不要把「一本书从无到有」和「写第 N 章」混成一条进度条。

书级：动笔前五阶段

合同：05-创作流程领域 §1A。

定盘 → 大纲/卷纲 → 设定拆条 → 范式与文风 → 细纲
 0        1           2            3            4

每步产物先落 Shadow，你确认后才变 Confirmed，才允许进入下一步的生成上下文。下层不得跟已确认的上层打架。

章级：三个节点

合同：05-创作流程领域 §2。

节点 P 规划  →  节点 W 正文  →  节点 A 章后

写第 N 章时围着这三节点转。节点 W 喂给写手的顺序写死：

库事实（作品 / 目标章 / 冻结点）
已确认细纲
前若干章正式正文
文风 + 已绑定范式
去 AI 味约束（只投影，不改正文）
方法合同（只读；自动检查待建）
本轮你的原话（第一轮可为空）

输出三块：Shadow 候选、门与诊断报告、决策菜单（改 / 丢弃 / 采纳）。Agent 不得自选。

flowchart TD
  A[可选: 拆书进库] --> B[定盘]
  B --> C[大纲 / 卷纲]
  C --> D[设定拆条]
  D --> E[选范式与文风]
  E --> F[第 N 章细纲]
  F --> G[写第 N 章候选]
  G --> H{你选}
  H -->|改| G
  H -->|丢弃| F
  H -->|采纳| I[正式正文]
  I --> J[抽卡草稿 / 案例草稿]
  J --> F

沿周期走

每一节先写这一步要完成什么，再写加载谁，再写里面有什么规则和工具。

素材进库（可选）

只在喂参考书或用户旧稿时走。不写你的新书。

功能链：full_parse → deconstruct-book → 抽取员。

Skill	意图	规则	工具
import-book	txt 分章写入作品、章、正文块	不调模型、不改写正文	`import_novel.py`
clean-book-text	删广告、水印、拉票、乱码	模型只提候选，脚本守卫才删	`clean_detect.py` / `clean_apply.py`
deconstruct-book	逆向拆细纲、阶段大纲、实体线索、脱敏写法	自底向上，和创作规划方向相反；细纲约正文 3–5%，卷纲约 0.3–0.5%；系统级拆书必须脱敏	`parse_ingest.py` 等；模型走 call-content-model（MiniMax-M3）
extract-work-knowledge	按窗口抽作品面实体、关系草稿	与既有知识冲突不覆盖，双版本待你裁决	`upgrade.py`
review-knowledge-cards	三种编辑视角审公共卡	不生成卡，不确认作品私有知识	`review_cards.py`
backup-work-extraction / reset-work-extraction / repair-work-extraction / inspect-parse-health	备份、重抽、修单窗、只读体检	四职互不代劳	各自 `scripts/`

知识要进检索，再走 embed-knowledge（写入向量）和 search-knowledge（按绑定和权限召回）。向量只是加速，命中后必须回读库行。

阶段 0 · 定盘（节点 P）

要完成：这本书是什么、写给谁、禁区在哪、篇幅目标（目标章数 × 单章字数 × 分卷数）。九个核心字段齐，你确认后才能往下。

功能链：setting_init → design-story-foundation → 规划师。

Skill	意图	规则	工具 / 方法
design-story-foundation	固化根设定，按固定三级章节树出可比较候选	候选不落库、不进 Canonical；你选完才交给规划	`validate_candidates.py`、`assert_selection_handoff.py`；合同在 `references/candidate-contract.md`
merge-story-candidates	多案逐章合成一案	一级章节一个新代理；根设定优先	`serial_merge.py`
concept-design	把「我想写 X」升级成能撑长篇的疑问	idea 是陈述，concept 是疑问；四问（新鲜 / 角度 / 冲突 / 可撑长），可撑长必须过	无脚本。见方法：概念设计

阶段 1 · 大纲 / 卷纲（节点 P）

功能链：planning → plan-story → 规划师。

意图：按结构清单逐字段产设定包、大纲、叙事状态、装配草稿。清单上有字段就必须写；写不出标「字段存疑:原因」，不许跳过。

本 Skill 不写细纲。 单章细纲只归 plan-chapter。

规划规则四条：

设定互相咬合：势力用力量阶梯表述，人物在阶梯上有坐标，地点对得上地盘。
伏笔成网：每条有埋设章和计划回收章。
与品类俗套的差异点必须写进题材定位。
「说话方式」必须是口头禅、句长、称呼习惯，不许「豪爽」「高冷」。

工具：

persist_planning.py：先 shadow，你确认后才 confirmed
select_patterns.py：只从公共范式召回，结果进装配草稿；未确认不得进正文上下文
record_planning_execution.py：把这次规划执行记成可追溯回执

这一步可选装载的方法 Skill：story-structure、story-planning、narrative-momentum、foreshadow-payoff、story-ending。

阶段 2 · 设定拆条（节点 P）

仍由 plan-story 产出知识卡草稿。转正走另一条轨：confirm-knowledge-draft。

意图：把设定拆成 23 型结构本体（人物、势力、地点、力量体系等）。型与字段在 meta/schemas/。每条带演变历程和成长弧。

规则：落库按对应 schema 校验必填，缺必填整单失败，不写半成品。全书闭环台账还是目标合同，目前以你确认为退出准绳。

建人可拉 character-design。定型之后怎么写进正文，归 character-presentation。

阶段 3 · 范式与文风（节点 P）

两件事：

plan-story 的 select_patterns：规划期选定本作范式，绑定进装配。写作期只引用已绑定的，不作临场海选。
功能链 voice_baseline → establish-voice-baseline：作品建立或新角色登场时，把已确认正文和作者样张做成声音账，版本化落库。平时不动。它是后面预防和修订的对照物。

文风八字段（人称视角、句式、叙述配比、用词、AI 味黑名单、对话、章末钩子、达标样张）目标是真注入写手。当前生产注入的是设定行的一句话文风，结构化八字段抽取尚未建成。

阶段 4 · 细纲（节点 P）

功能链：fine_outline → plan-chapter → 规划师。

前置：assemble-context 先组装规划视图。回放时所有来源章号必须早于冻结点；目标章正文和目标章答案细纲一律禁读。

意图：把已确认大纲变成结构骨架，不是缩写。篇幅大约是章正文的 3–5%。

必填（缺一不得落库、不得给写手），字段权威 fine_outline.yaml：

字段	白话
`chapterGoal`	本章要完成的戏剧任务
`hardConstraints`	不可删除、反转、提前回收的硬骨架
`keyEvents`	触发、参与者、行动、结果方向必须互相解释
`mustAppearEntities`	必须出场的实体
`chapterEndHook`	章末钩子
`declaredNewFacts`	本章宣告的新事实

伏笔动作只能写：埋 / 推进 / 回收 / 不确定。不确定进 unknowns。不写正文，不对白，不复述目标章答案。

落库必须带 --owner-skill plan-chapter。用 plan-story 默认身份写细纲会失败关闭。

可选检测：check-content-consistency（细纲分支）、score-content-quality（只评结构，不评文笔）。

细纲里派场景任务，可装载 scene-craft。

该章细纲经你确认，才能进入节点 W。

节点 W · 写一章正文

这是主链。加载顺序在合同里写死。

prevent-ai-flavor
  → assemble-context（冻四层，只投影给写手该看的）
  → write-next-chapter → writer（无工具，只回 candidateBody）
  → 机械门（篇幅、结构、细纲锚点、哈希）
  → 语义检测 check-content-consistency
  → diagnose-ai-flavor（只查不改）
  → Shadow 候选给你看

你说「写第 N 章」= 授权本轮产 Shadow。你说「改：……」= 原话进入下一轮第 7 项，不入库。你说「采纳」才走节点 A。

必用

Skill	意图	规则	工具
prevent-ai-flavor	生成前把现行规则负约束和声音账正样例冻进上下文	不碰正文；不承诺零 AI 味；声音账缺失就诚实留空，不许拿「真人文风」冒充	`prevent_ai_flavor.py`
assemble-context	从库读可信来源，冻成完整上下文，再按角色裁最小投影	卡只是索引，必须按指针回读原文；历史必须早于冻结点；写手看不见运行号、哈希、实验臂、标准答案	`assemble_writer_context.py`、`persist_context_freeze.py`、`writer_contract.py`
freeze-context	被组装器向下调用：冻结清单、泄漏审计、只读装载	不调模型、不写正式数据	`build_snapshot.py`、`check_snapshot.py`、`audit_leakage.py`
write-next-chapter	按已确认细纲写整章候选	硬事件、伏笔动作、出场、钩子不可删、反转、提前收；可设计新设定，但不得冒充已确认事实；写手看到 4000–7000 字，机械门大于 3000 且不超过 10000	`run_writer.py`、`run_writer_pipeline.py`、`candidate_cas.py`
check-content-consistency	语义核查	证据不足必须标未知，不许猜成通过；新设定进候选清单，不因此禁写	`run_writer_semantic_detector.py`
diagnose-ai-flavor	用现行规则库扫出精确片段	没有这份产物，修订 Skill 拒绝启动	`diagnose_ai_flavor.py`

写手只返回：

{"candidateBody":"一章完整正文"}

哈希、版本、验收状态由可信适配器算，不由模型生成。

你授权才改内容

你说什么	加载	边界
改指定范围	rewrite-selection	范围外原文不动；先核对期望版本号
场景太薄	expand-scene	只加厚动作链、潜台词、感官；不新开场景、不改落点
只修表达	polish-prose	不改情节事实。不是去 AI 味入口
去 AI 味	必须先诊断，再 revise-ai-flavor	最小改动；没诊断不启动；你不点头永远是候选
采纳 / 丢弃	decide-candidate	Canonical 的唯一入口

decide-candidate 两步不可颠倒：先 check_writer_acceptance.py（纯检查、不写库），过了再 write_canonical.py 单事务写入。语义未过不得接受。评测候选任何情况下不得成为正式正文。

采纳正文 ≠ 确认知识。知识转正走 confirm-knowledge-draft。规划确认走 persist_planning.py confirm。

方法装载（目标：自动只读检查；现状待建）

这些不进功能链，挂在节点 W 作参考。细节见方法 Skill 内部设计。

Skill	这一章用它看什么
scene-craft	这场戏干什么、给多少篇幅、从哪进哪出
dialogue-craft	这段该不该用对话、每段做了哪件事
character-presentation	读者能不能自己看见这个人
show-and-omission	有没有把结论直接递给读者
narration-pov	用谁的眼睛、站什么立场
prose-craft	句长、密度、温度
theme-and-stance	主题是演示出来的还是说教
narrative-momentum	章末为什么翻得下去
foreshadow-payoff	这一章是埋、推还是收

质量评分 score-content-quality 在生产链上尚未接线。盲评目前主要用于离线回放。

节点 A · 你采纳之后

decide-candidate 把当前候选写成库内正式正文，并授权下游草稿自动生成。草稿转正式仍要你点头。

Skill	意图	现状
extract-chapter-knowledge	从已接受章抽实体、关系、事件草稿	合同已建；异步执行未建，接受时只登记待办投影
capture-ai-flavor-cases	从正文或反馈抽 AI 味案例卡	已建，默认写库
promote-ai-flavor-rule	案例 → 样例 → 规则候选 → 评测 → 你激活	不碰本次正文
confirm-knowledge-draft	你确认后草稿变正式实体，并迁移向量归属	已建；与正文轨表集不交
establish-voice-baseline	新角色登场或声音定版	偶尔跑

去 AI 味五步不可跳级：

定基线（垫底，偶尔跑）
  → 每次写之前预防
  → 写完诊断
  → 你同意后最小修订
  → 门禁
  → 你确认转正
背后挖掘规则（promote），不进这次正文

共享运行时在 humanization/。规则权威是库表，读库失败就关闭，不静默退回 Git 里的文件。

写手看见的四层上下文

合同：assemble-context，设计 SoT 在父仓专题-03。完整上下文留在可信边界，模型只收到角色投影。

层	是什么	裁剪纪律
L0 当前任务	目标章、细纲、篇幅、你的指令	硬约束不得裁掉
L1 历史正文	连续前四章 + 按卡指针回读的补充原文	先保连续基线
L2 作品事实	正式卡索引、设定、叙事状态	逐字段授权，不倾倒整库
L3 授权参考	已绑定范式、样张	只在这条功能链需要时加入

两个词不要混：

purpose（generation / planning / extraction / detection）：决定字段看得见哪些。
scenario（continuation / fine_outline / …）：决定加载哪只功能 Skill。

卡是索引，不是原文替代。生成或审查使用卡内历史事实前，必须按来源指针回读冻结快照里的历史原文。

保护步骤主会话不能绕：结构校验 → 上下文冻结 → 机械门 → 语义检测 → 接受前置校验 → 带版本比较的库内写入。

方法 Skill 内部设计

15 只方法 Skill 从写作书蒸馏而来。SKILL.md 只留动作索引；步骤、案例、引文在 references/。它们不写 Canonical。当前复利多半只通一侧：能指导规划或装配，还不自动把「这次怎么做」沉淀成库内经验卡。

下面每只给「何时用 / 内部动作 / 细节文件」。想练手，打开对应 references/ 里的清单。

动作	规则	细节
升级	idea 是陈述句，concept 是「如果……会怎样」	`references/what-if.md`
校验	新鲜、新角度、冲突、可撑长四问；可撑长必须过	`references/four-questions.md`
真实素材	事件改不了，换「通过谁的眼睛看」就是不同故事	`references/delivery-strategy.md`
找角度	原创不是题材新，是精确说出自己的看法	`references/originality.md`
引擎	主题陈述不是引擎，具体问题才是翻页理由	`references/story-engine.md`

动作	规则	细节
四箱	Setup 0–25% / Response 25–50% / Attack 50–75% / Resolution 75–100%，功能不能提前也不能延后	`references/four-boxes.md`
六里程碑	Hook、第一情节点、两个夹点、中点、第二情节点；位置是硬约束	`references/six-milestones.md`
Setup 五使命	赌注、共情、背景、内在恶魔、钩子加伏笔	`references/setup.md`
触发事件	1–15% 打破平衡；之后每 3–5 章把赌注抬一级	`references/inciting-incident.md`
漫游者	25–50% 主角只能跑、躲、观察，禁止主动解决问题	`references/part2-wanderer.md`
中点	50%±3% 从被动转主动；没有中点，四箱塌成两箱	`references/midpoint.md`

动作	规则	细节
选工作流	凭灵感写不是不规划，是用 3–5 稿代替规划	`references/plan-vs-pantsing.md`
节拍表	一场一行，写使命和关键内容，可重排	`references/beat-sheet.md`
动笔	先定第一句和最后一句；中间不中途修改	`references/draft-flow.md`

发动机	规则	细节
势	事件接成不可逆链条；每一环处境、心理、动作三要素齐；删掉一环还成立，这一环就没用	`references/build-momentum.md`
金币	中段每约 1 万字至少一枚具体小奖励，不必推进主线	`references/midway-rewards.md`
钩子	断点放未解的小问题；最后一句是问题或动作中断，不是答案总结	`references/breakpoint-hooks.md`

动作	规则	细节
登记	被镜头对准、被反复提及的元素是向读者借款；建台账，找不到兑现点就删或降低显著度	`references/register-and-repay.md`
自然埋	特殊人物或事件出场前，先垫 2–4 个普通同类台阶	`references/natural-staircase.md`
兑现	高潮由一个已埋的微小动作、物品或一句话触发	`references/detail-driven-climax.md`

动作	规则	细节
定使命	一场只交付一件：一条关键事实、一个不可逆决定，或一次状态改变	`references/scene-mission.md`
定详略	冲突、转变、启示详写；推进、过渡、背景略写	`references/scene-detail.md`
定进出	晚进入、早退出；张力释放完立刻切	`references/scene-entry-exit.md`
定镜头	鸟瞰 / 建立 / 中景 / 特写 / 极端特写；全程中景是扁平的头号原因	`references/scene-camera.md`
排节奏	默认详-略-详	`references/scene-rhythm.md`
藏接缝	用细节延续掩盖拼装，禁止作者跳出来替读者解读	`references/scene-mystification.md`

动作	规则	细节
该不该用	冲突与高潮用对话；信息、背景、前情用叙述	`references/when-to-use-dialogue.md`
派任务	推进关系、改变权力、揭示人物，三件至少做一件	`references/dialogue-does-things.md`
建声音	每人至少 2 个语言区别点；抽出来分不清是谁就是失败	`references/character-voice.md`
磨质感	要有半句、重复、打断；也不能是逐字录音	`references/real-speech-texture.md`
删标签	「他严肃地说」把读者推出场景；用动作归属	`references/tags-and-attribution.md`

动作	规则	细节
建	7 个可独立调节的变量，前 6 个是输入，行为是输出兼测试	`references/seven-variables.md`
立体	表层面具 / 内层自己 / 深层连自己都不知道的核心；三层完全一致就是一维	`references/three-dimensions.md`
驱动	外部冲突必须激活内在恶魔；只有外部冲突，角色是剧情搬运工	`references/inner-demon.md`
定形	一句话说得清的大概率扁平；圆形 = 出人意料 × 仍然可信	`references/flat-vs-round.md`
打底	用原型，别让原型用你；在读者期待的位置反转	`references/archetype-reversal.md`

动作	规则	细节
细节装配	从多个维度挑 5–9 个能反推出性格的感官细节	`references/detail-mosaic.md`
内在可见	必须写没说出口的感情和幻想	`references/visible-private-life.md`
关系网	「他是谁」要问他的关系网，至少三重，而且要对比	`references/relationship-web.md`
性格碰撞	不让主人公倒霉，让他遇到另一个人	`references/character-collision.md`
反常瞬间	应该这样却没这样；落实成一个动作或一句对话	`references/abnormal-moment.md`

动作	规则	细节
换标签	愤怒、阴森、勇敢换成动作、数字、场景、对话	`references/show-vs-tell.md`
极端情绪	关掉「他感到」，改写手、眼、耳、身体	`references/extreme-emotion-body.md`
留白	缺席、反常、飞白；空白处必须留可反推的暗示	`references/anti-logic.md`
知情范围	视角人物只说、只想他视角内的信息	`references/pov-knowledge-boundary.md`

动作	规则	细节
选视角	人物看到什么，读者才看得到	`references/pov-camera.md`
外来者	不直接批判封闭系统，让外来者碰壁	`references/outsider-entry.md`
主线与折线	主线运行动，折线停车上意义；约 2:1，折线必须落回场景	`references/broken-line.md`

旋钮	规则	细节
句长	长句载着走，短句踩刹车；相邻五句不许单轨	`references/sentence-rhythm.md`
抽象梯子	问「能给一个例子吗」往下走；问「那是什么意思」往上走	`references/abstraction-ladder.md`
修辞温度	重场景克制，轻场景才炫技	`references/rhetoric-density.md`
抒情	不写「我多么 X」，写一个动作	`references/lyric-restraint.md`
白描	不写「他很 X」，写一个等于 X 的动作	`references/plain-description.md`

动作	规则	细节
演示	决策演示、结构演示、反讽演示；角色说出主题就变成传声筒	`references/theme-demonstration.md`
反席勒化	不写「批判 X」，写一个具体场景加一个性格鲜明的当事人	`references/stance-by-logic.md`
心慈手狠	每个主要人物要有狠瞬间；「舍不得」是手软信号	`references/mercy-ruth.md`
幽默	面对无法改变的痛苦，幽默是结构不是插科打诨	`references/humor-as-stance.md`

链	Skill	做什么
细纲回放	evaluate-frozen-replay	冻到指定章号，三臂规划师 + 盲检测 + 双盲评委
正文回放	load-replay-reference-work → replay-writer-gate	只读装配真实书；三臂写手 + 盲评
裁决	adjudicate-quality-gate	从不可变回执出通过/不通过，评分层不得改写
归因建议	optimize-content-quality	锁定最低分维度，只出单变量建议，不重生成
探针	refresh-runtime-probe	写手合同升级后重签能力探针

Skill	作用
access-database	唯一通用数据库入口。专用导入、嵌入、检索仍走各自 Skill
call-content-model	内容模型统一入口：额度窗、降级、重试、JSON 提取
execute-role-task	冻结 prompt/schema/profile 下的受治理角色调用
record-run-evidence	运行登记、不可变回执、原文证据、经验待审记录

Skill	调用	一句话
access-database	自路由	受控查库、改库、跑可审计 DDL
call-content-model	自路由	New-API 治理入口
dispatch-agent-task	编排	显式模型策略下派发框架子代理并留痕
execute-role-task	编排	跑一次受治理角色任务
record-run-evidence	编排	运行、回执、原文证据
refresh-runtime-probe	编排	重签写手能力探针

Skill	调用	一句话
import-book	自路由	txt 分章落库
clean-book-text	自路由	删语义垃圾，不改写
deconstruct-book	编排	全书拆细纲、大纲、范式
extract-work-knowledge	编排	按窗抽作品面知识草稿
backup-work-extraction	编排	抽取状态备份与恢复
reset-work-extraction	编排	全量重抽前清空派生状态
repair-work-extraction	编排	修单窗、去重、迁移
inspect-parse-health	编排	只读体检拆书与升格终态

Skill	调用	一句话
embed-knowledge	自路由	知识写入向量索引
search-knowledge	自路由	按意图召回并裁权限
freeze-context	编排	冻到来源清单，查泄漏
assemble-context	编排	组装并按角色投影
extract-chapter-knowledge	编排	章后抽卡草稿
review-knowledge-cards	自路由	审公共卡 pass / revise / reject

Skill	调用	一句话
concept-design	自路由	点子升级为长篇概念
design-story-foundation	编排	根设定 + 三级章节树候选
merge-story-candidates	编排	多案串行统合

Skill	调用	一句话
plan-story	编排	书级设定、大纲、装配草稿
plan-chapter	编排	单章细纲，唯一写入方
story-structure	自路由	四箱 + 六里程碑
story-planning	自路由	节拍表与工作流
narrative-momentum	自路由	势、金币、钩子
foreshadow-payoff	自路由	埋、铺台阶、兑现
story-ending	自路由	终局倒推与收尾姿态

Skill	调用	一句话
write-next-chapter	编排	按细纲写整章候选
expand-scene	编排	场景内加厚
rewrite-selection	编排	按你点名的范围重写
polish-prose	编排	只修表达层
scene-craft	自路由	场景六问
dialogue-craft	自路由	对话当事件写
character-design	自路由	建人五动作
character-presentation	自路由	让读者自己看见人
show-and-omission	自路由	展示与留白
narration-pov	自路由	视角、立场、叙述模式
prose-craft	自路由	句子与段落旋钮
theme-and-stance	自路由	主题演示与作家立场

Skill	调用	一句话
check-content-consistency	编排	结构、事实、伏笔、证据缺口
score-content-quality	编排	按量表打分，不裁决
adjudicate-quality-gate	编排	Gate 终态唯一来源
optimize-content-quality	自路由	最低维归因，只出建议
evaluate-frozen-replay	编排	细纲隔离回放
replay-writer-gate	编排	正文三臂回放
load-replay-reference-work	编排	只读装配回放用书
novel-diagnosis	自路由	整本体检后分流

Skill	调用	一句话
establish-voice-baseline	编排	声音账定版
prevent-ai-flavor	编排	生成前约束投影
diagnose-ai-flavor	编排	只查不改
revise-ai-flavor	编排	诊断之后的最小修订
capture-ai-flavor-cases	编排	抽取案例卡
promote-ai-flavor-rule	编排	案例升格为现行规则

Skill	调用	一句话
decide-candidate	编排	正文草稿变正式正文的唯一闸口
confirm-knowledge-draft	自路由	知识草稿变正式实体

45 KiB Raw Blame History Unescape Escape

创作周期与 Skill 导读

怎么用这份文档

先记住三件事

1. 分类不是加载

2. 角色文件不写「这次做什么」

3. 人盯的是「创作内容变没变」

系统里的五种角色

一次任务怎么加载 Skill

两条时钟

书级：动笔前五阶段

章级：三个节点

沿周期走

素材进库（可选）

阶段 0 · 定盘（节点 P）

阶段 1 · 大纲 / 卷纲（节点 P）

阶段 2 · 设定拆条（节点 P）

阶段 3 · 范式与文风（节点 P）

阶段 4 · 细纲（节点 P）

节点 W · 写一章正文

必用

你授权才改内容

方法装载（目标：自动只读检查；现状待建）

节点 A · 你采纳之后

写手看见的四层上下文

方法 Skill 内部设计

concept-design 概念设计

story-structure 故事结构

story-planning 规划工作流

narrative-momentum 叙事动力

foreshadow-payoff 伏笔与回收

story-ending 结尾

scene-craft 场景执行

dialogue-craft 对话

character-design 人物设计

character-presentation 人物呈现

show-and-omission 展示与留白

narration-pov 视角与叙述

prose-craft 语言修辞

theme-and-stance 主题与立场

novel-diagnosis 作品诊断

开发评测链（不是日常写书）

贯穿底座（不绑创作功能链）

58 只 Skill 总表

平台底座 · 6

素材导入与拆解 · 8

知识与上下文 · 6

概念与前期 · 3

结构与规划 · 7

正文写作与呈现 · 12

检测、评分与诊断 · 8

去 AI 味与人感 · 6

候选主权 · 2

节点 × Skill 挂载（编排菜单）

现状：设计有了、机械还没接上的部分

合同原文在哪

45 KiB

Raw Blame History

节点	必用	可选（自动报告）	你授权才用
P 规划	assemble-context，plan-story 或 plan-chapter	方法只读检查；check-content-consistency	生成/改规划草稿，以及 confirmed
W 正文	prevent-ai-flavor → assemble-context → write-next-chapter → 机械门 → 语义 → diagnose-ai-flavor → Shadow	方法只读检查；score-content-quality（生产待建）	「写/改」产候选；revise / polish / rewrite；decide-candidate
A 章后	接受触发的下游草稿：extract-chapter-knowledge、案例/规则候选	经验待审记录；只读汇总	confirm-knowledge-draft；规则激活；声音账定版；下一章开写

你想确认	打开
阶段顺序、人机分界、节点菜单	05-创作流程领域
这次该加载哪只功能 Skill	meta/chains/README.md
58 只 Skill 挂在哪一段	.agent/skills/_index.md
某只 Skill 的输入、红线、工具	`.agent/skills/<名字>/SKILL.md`
方法细节、案例、清单	同目录 `references/`
细纲字段	meta/schemas/fine_outline.yaml
角色不做什么	.agent/agents/
Skill 分类字段含义	skill-quality-rubric.md
谁拥有作品、实体、范式、上下文	领域索引