muse-agent-example/.claude/skills/_index.md

.claude/skills 总目录

本目录同时承载两类 skill，请按标签区分：

• 【运行时】：绑定 scenario，由 ../meta/chains 登记；任务派发时由 assemble-context 调用
• 【方法论参照】：craft 试用区，从 7 本写作书蒸馏出的 15 个综合 skill，供 writer 角色和创作环节按需取用。不落库、无数据库合同、不进 meta/chains

craft 15 个综合 skill 的分类、合并与裁剪权威为 ../craft/MERGE_PLAN.md，维护门禁见 ../craft/scripts/check_craft_skills.py。原料层（94 个源单元）保留在 ../craft/books/。

---

运行时技能（绑链，33 个）

Skill	用途
access-database	通过唯一受控入口查询或修改 muse-example PostgreSQL，并应用可审计 DDL。主会话或 Skill 需要通用数据库访问时使用；专用导入、嵌入和检索仍走各自 Skill。
assemble-context	按冻结点从 PostgreSQL 读取可信来源，组装可审计上下文，并为 writer、detector、judge、planner 或 extractor 生成最小投影。
call-content-model	通过 New-API 的统一治理入口调用内容模型，执行额度窗口、模型降级、重试和 JSON 提取。
capture-ai-flavor-cases	从已有作品或创作反馈中抽取可复核的 AI 味案例卡，保留来源哈希与位置并产出规则候选。
check-content-consistency	检查正文或细纲候选的结构、事实、角色状态、能力代价、伏笔和证据缺口；只产检测报告。
clean-book-text	识别并删除参考书或旧稿中的广告、水印、作者拉票和乱码噪声，同时保留逐段审计；不改写正文。
decide-candidate	根据用户明确指令接受、合并或丢弃 Shadow 候选，并以受控事务更新 Canonical。
deconstruct-book	从完整存量作品逆向拆出章节细纲、阶段大纲、实体线索和脱敏写作范式。
design-story-foundation	在正式规划前固化作品根设定，按固定三级章节树生成可比较的前期设计候选。
diagnose-ai-flavor	对目标正文跑 active 规则库，产出带精确片段与证据的发现清单，检测完成自动落库；只查不改。
embed-knowledge	使用固定 Qwen3 嵌入模型将知识草稿或实体批量写入 pgvector，并按内容哈希幂等处理。
establish-voice-baseline	作品建立或新角色登场时，把已确认正文与作者样张产出的声音账做结构校验后版本化落库。
evaluate-frozen-replay	将参考作品冻结到 as_of 章号，编排细纲或正文的隔离回放，并生成可审计的逐样本结果。
execute-claude-task	以冻结执行配置在 fresh 沙箱子进程中调用 Claude CLI，并校验模型、期限与结构化输出。
expand-scene	在既有场景内补充动作链、对话潜台词、感官细节和环境互动。
extract-chapter-knowledge	从已接受章节抽取实体、关系、事件和叙事状态草稿，并提出既有知识更新。
extract-work-knowledge	将已完成拆解的作品正文按窗口抽取为 upgrade_book 实体、关系与演变草稿。
freeze-context	将截至指定章号的来源冻结为可重复清单，并校验授权、版本、未来信息泄漏和只读原文装载。
import-book	将参考书或用户旧稿 txt 确定性分章并写入作品、章节、正文 block 和来源档案。
maintain-work-extraction	维护既有 upgrade_book 抽取状态，包括七域备份验证与恢复、全量重抽前重置、失败窗口恢复。
optimize-content-quality	根据独立评分锁定最低质量维度，以单变量方式调整 prompt、上下文或设定并有限重生成。
plan-chapter	根据已确认规划、叙事状态和冻结事实生成下一章结构细纲草稿。
plan-story	按正式 schema 生成或修订作品设定包、大纲、知识卡、状态和装配草稿。
polish-prose	修正候选或既有正文的错字、语病、AI 味、节奏和角色声音；不改变情节事实与场景结构。
prevent-ai-flavor	生成前组装写作上下文合同——active 规则的负约束（附反例）加声音账的正样例与保护项。
record-run-evidence	记录模型调用、运行登记、不可变回执、CAS revision 和受控 raw 证据。
review-knowledge-cards	以三种编辑视角审核公共知识卡的成立性、创作可用性和跨书复用性，并写回 pass、revise 或 reject。
revise-ai-flavor	在诊断产物与作者同意之上执行最小 patch，过硬门、复扫与成对选择校验；没诊断不启动。
rewrite-selection	按用户意见重写指定段落或场景，并校验范围、事实锚和版本；范围外原文不动。
score-content-quality	按独立 rubric 评分在线正文、正文回放或细纲回放，并产生逐维证据和 Gate 裁决输入。
search-knowledge	将创作意图嵌入后从 pgvector 召回知识，并按绑定、状态和 aiContext 权限裁剪结果。
write-next-chapter	按已确认细纲、冻结事实和动态篇幅合同生成下一整章候选；不自行检索、不把候选直接写入 Canonical。

---

方法论参照（craft，15 个）

按领域

领域	Skill	一句话定位
概念与前提	concept-design	把模糊点子变成能撑长篇的疑问式概念：升级、四问校验、找角度、真实素材交付策略
结构与里程碑	story-structure	先按体裁选尺子，再搭"四箱+六里程碑"骨架，把开头/启动/转折/加码放对位置
动力与钩子	narrative-momentum	读者翻页的三个来源：势（不可逆推力链）、金币（沿途小奖励）、钩子（断点未解问题）
结尾	story-ending	结尾回答两问：终局在哪（工程：倒推回响），终局给读者什么（姿态：关起来还是打开）
伏笔与回收	foreshadow-payoff	伏笔全链路：登记埋设 → 自然生长 → 兑现/高潮
人物设计	character-design	五个动作：建（7变量）、立体（三层）、驱动（内在恶魔）、定形（扁平/圆形）、打底（原型）
人物呈现	character-presentation	让人物被读者自己看见：不宣告、细节装配、内在可见、关系网、性格碰撞、反常瞬间、自己的声音
场景执行	scene-craft	场景六问：干什么、给多少篇幅、从哪进哪出、镜头多远、细节怎么选、转场怎么不着痕
展示与留白	show-and-omission	不把结论递给读者，给读者能自己得出结论的材料；写出来的是抓手，没写的是分量
对话	dialogue-craft	对话是事件不是装饰：该不该用、每段派任务、让人物自己暴露、水下留白
叙述与视角	narration-pov	三件事：用谁的眼睛看（视角）、站什么立场讲（立场）、讲的过程怎么走（张力与模式）
主题与立场	theme-and-stance	主题是读者自己看出来的，不是作者说的；立场不先行，命运执行不手软，沉重题材用幽默作结构
语言与修辞	prose-craft	语言的可诊断可调节旋钮：节奏、密度、温度、情感出口、抽象层级、风格杠杆
规划工作流	story-planning	把"找故事"挪到动笔前，用廉价的规划稿替换昂贵的重写
作品诊断	novel-diagnosis	整体体检三段：维度框架定位 → 五透镜查病灶 → 评审纪律清理结论

按创作环节取用

对应本仓创作链（环节合同见上"运行时技能"）：

创作环节	首选	辅助
前期设计（design-story-foundation）	concept-design	story-structure（体裁尺子）
规划/大纲（plan-story）	story-structure, story-planning	foreshadow-payoff（伏笔台账）, narrative-momentum（金币布点）
章级细纲（plan-chapter）	scene-craft（场景任务）, narrative-momentum（章末钩子）	foreshadow-payoff（埋设/回收位）
正文写作（write-next-chapter, expand-scene）	scene-craft, dialogue-craft, character-presentation	show-and-omission, narration-pov, prose-craft
润色（polish-prose）	prose-craft	show-and-omission, dialogue-craft
审查/评分（score-content-quality, judge）	novel-diagnosis	theme-and-stance（说教检查）, character-design（人物体检）, story-structure（位置校验）
去 AI 味（prevent/diagnose/revise-ai-flavor 家族）	prose-craft（温度与克制）, show-and-omission	character-presentation（动作呈现）