# .claude/skills 总目录

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

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

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

### 按创作环节取用

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

| 创作环节 | 首选 | 辅助 |
|----------|------|------|
| 前期设计（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（动作呈现） |