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

# Skill 发现总索引

> **发现合同**：任何 agent（不限宿主）读 [`AGENTS.md`](../../AGENTS.md) 后必须读本索引，需要某项能力时按 `skill_file` 读对应 `SKILL.md`。发现只靠 AGENTS.md → 本索引 → SKILL.md 的渐进披露，不依赖任何 coding agent 的 skill 自动发现；物理目录位置只是索引里的数据。

本索引只登记三字段：`skill_name`（目录名，即调用名）、`skill_file`（合同文件路径）、`skill_description`（适用与边界描述，与 SKILL.md frontmatter 逐字一致，frontmatter 是 SoT）。分类字段（`lifecycle` / `invocation` / `side_effects` / `compounding`）逐个登记在 [`harness/manifests/skills.json`](../../harness/manifests/skills.json)，由 `harness/skill_harness.py` 机械校验，不在本索引重复。

本文件由 `harness/skills_index.py --write` 生成，手改会被覆盖；一致性由 `--check` 与 `tests/architecture/test_skills_index.py` 机械把关。按生命周期分域，共 58 个 skill。

## 0 平台底座

| skill_name | skill_file | skill_description |
|---|---|---|
| access-database | `.agent/skills/access-database/SKILL.md` | 通过唯一受控入口查询或修改 muse-example PostgreSQL，并应用可审计 DDL。主会话或 Skill 需要通用数据库访问时使用；专用导入、嵌入和检索仍走各自 Skill，禁止裸连和一次性脚本。 |
| call-content-model | `.agent/skills/call-content-model/SKILL.md` | 通过 New-API 的统一治理入口调用内容模型，执行额度窗口、模型降级、重试和 JSON 提取。清洗、拆书或知识审核需要 MiniMax 等内容模型时使用；不得裸调外部服务。 |
| dispatch-agent-task | `.agent/skills/dispatch-agent-task/SKILL.md` | 把冻结角色任务包派发给 Agent 框架子代理执行并自动留痕：注入角色 prompt 与输出 Schema、按白名单开放工具、归一框架事件流写入代理事件账本，结构化输出经 Draft 2020-12 校验后返回回执。任何 Agent 框架（当前 pi）执行 writer/planner/detector/judge/extractor 角色任务时使用；不经框架的直接 HTTP 批处理走 execute-role-task；本 Skill 不做补证、重写等业务决策。 |
| execute-role-task | `.agent/skills/execute-role-task/SKILL.md` | 以冻结 RoleExecutionProfile 运行一次不经框架的直接 HTTP 角色调用，校验模型策略、期限、预算、结构和输入输出哈希并返回 RoleExecutionReceipt。writer、planner、extractor、detector 或 judge 的无工具批处理需要直接模型调用时使用；需要框架原生 ReAct/工具循环的子代理执行走 dispatch-agent-task；能力探针刷新交给 refresh-runtime-probe，本 Skill 不负责保存 raw、登记运行或裁决业务结果。 |
| record-run-evidence | `.agent/skills/record-run-evidence/SKILL.md` | 记录模型调用、运行登记、不可变回执、CAS revision 和受控 raw 证据。执行器或业务 Skill 需要持久化一次运行、追加失败证据、补回执引用或管理 raw 备份时使用；不负责调用模型或裁决内容质量。 |
| refresh-runtime-probe | `.agent/skills/refresh-runtime-probe/SKILL.md` | 通过 execute-role-task 用当前 writer 提示词、结构和档案实跑一次极小合成角色任务，刷新运行探针记录与自哈希并把完整配置写到新文件。角色合同或运行时、模型策略版本变化导致执行门失败时使用；不就地覆盖原配置，不把离线预览伪装成成功证明。 |

## 1 素材导入与拆解

| skill_name | skill_file | skill_description |
|---|---|---|
| backup-work-extraction | `.agent/skills/backup-work-extraction/SKILL.md` | 对单本作品的 upgrade_book 派生状态做七域一致性备份、离线复验、回滚演练与精确恢复。需要在重置或高危维护前留下可复验快照、或需要把作品抽取状态恢复到某个备份点时使用；不负责重置、定向修复和正常按窗抽取。 |
| clean-book-text | `.agent/skills/clean-book-text/SKILL.md` | 识别并删除参考书或旧稿中的广告、水印、作者拉票和乱码噪声，同时保留逐段审计。静态导入后仍有语义垃圾时使用；模型只提候选，确定性守卫决定是否删除，绝不改写正文。首次 txt 分章落库归 import-book；本 Skill 只在已有 block 上做语义噪声清洗。 |
| deconstruct-book | `.agent/skills/deconstruct-book/SKILL.md` | 从完整存量作品逆向拆出章节细纲、阶段大纲、实体线索和脱敏写作范式。需要解析用户旧稿或参考书全书时使用；不负责把作品面知识按窗升格，也不确认产物。 |
| extract-work-knowledge | `.agent/skills/extract-work-knowledge/SKILL.md` | 将已完成拆解的作品正文按窗口抽取为 upgrade_book 实体、关系与演变草稿。作品完成拆书后需要建立本书知识面、续跑抽取窗口或查看抽取进度时使用；备份/恢复归 backup-work-extraction，全量重置归 reset-work-extraction，定向修复/迁移归 repair-work-extraction，本 Skill 不负责这三类维护。 |
| import-book | `.agent/skills/import-book/SKILL.md` | 将参考书或用户旧稿 txt 确定性分章并写入作品、章节、正文 block 和来源档案。首次导入完整书稿或明确重导时使用；不调用模型、不改写正文。导入后散落广告/乱码/拉票等语义噪声归 clean-book-text，本 Skill 不做 M3 探测删除。 |
| inspect-parse-health | `.agent/skills/inspect-parse-health/SKILL.md` | 只读体检拆书与升格两条管线的终态，并导出范式卡与升格实体卡样张。需要在一批跑完后机械核对章级细纲、窗级大纲、范式出卡和作品面升格四层健康度、或需要呈报样张时使用；不负责解析、抽取和任何修复动作。 |
| repair-work-extraction | `.agent/skills/repair-work-extraction/SKILL.md` | 对已有 upgrade_book 抽取结果做定向修复与存量迁移，包括 legacy failed 窗口恢复、单卡质量修复、presence 重复清理、存量窗口章号定位和存量回洗。需要修补个别窗口或行而不是重跑全书时使用；正常按窗抽取归 extract-work-knowledge，全量重置归 reset-work-extraction，备份恢复归 backup-work-extraction。 |
| reset-work-extraction | `.agent/skills/reset-work-extraction/SKILL.md` | 全量重抽前预览或清空单本作品的 upgrade_book 派生状态，把窗口退回 pending。需要对一本书重新跑一遍作品面抽取时使用；正常按窗抽取归 extract-work-knowledge，定向修复归 repair-work-extraction，备份恢复归 backup-work-extraction。 |

## 2 知识与上下文供给

| skill_name | skill_file | skill_description |
|---|---|---|
| assemble-context | `.agent/skills/assemble-context/SKILL.md` | 按冻结点从 PostgreSQL 读取可信来源，组装可审计上下文，并为 writer、detector、judge、planner 或 extractor 生成最小投影。创作或评测调用模型前需要受控上下文时使用。 |
| embed-knowledge | `.agent/skills/embed-knowledge/SKILL.md` | 使用固定 Qwen3 嵌入模型将知识草稿或实体批量写入 pgvector，并按内容哈希幂等处理 owner 与版本。知识行需要建立或刷新检索向量时使用；不嵌入参考书全文。 |
| extract-chapter-knowledge | `.agent/skills/extract-chapter-knowledge/SKILL.md` | 从已接受章节抽取实体、关系、事件和叙事状态草稿，并提出既有知识更新。正文进入 Canonical 后需要章后增量知识时使用；只产草稿，不自动确认知识。 |
| freeze-context | `.agent/skills/freeze-context/SKILL.md` | 将截至指定章号的来源冻结为可重复清单，并校验授权、版本、未来信息泄漏和只读原文装载。上下文组装或回放评测需要稳定时间边界时使用；不调用模型、不写正式数据。 |
| review-knowledge-cards | `.agent/skills/review-knowledge-cards/SKILL.md` | 以三种编辑视角审核公共知识卡的成立性、创作可用性和跨书复用性，并写回 pass、revise 或 reject。拆书产出公共卡后使用；不负责生成卡或确认作品私有知识。 |
| search-knowledge | `.agent/skills/search-knowledge/SKILL.md` | 将创作意图嵌入后从 pgvector 召回知识，并按绑定、状态和 aiContext 权限裁剪结果。管理审查或上下文组装需要知识候选时使用；不返回参考书全文，不绕过作品绑定。 |

## 3 概念与前期设计

| skill_name | skill_file | skill_description |
|---|---|---|
| concept-design | `.agent/skills/concept-design/SKILL.md` | 激活场景：用户手里只有模糊 idea、真实素材或"写了一半散掉"的稿子，还没形成能撑长篇的概念——"我想写 X 但不知道够不够"、"我的点子太平"、"题材写烂了，我没新意"、"真实事件想写成小说"、"朋友问小说讲什么我答不上来"、"写到一半故事散了"、"教学生怎么从 idea 到 concept"（教学演示）、"我有 3 个 idea，哪个最有潜力"（比较选择）、"朋友推荐我写 X，怎么判断值不值得"（第三方评估）、"真实人物的真实经历（传记/回忆录）怎么让它有 concept"、"读到一本好书/好新闻，想改写成小说"（非虚构改编）。关键 trigger："what if / 把 idea 变成 concept / 升级点子 / 故事种子 / premise / 这个点子够不够 /这个点子能写成小说吗 / 能撑 30 万字吗 / 哪个 idea 最有潜力 / 题材写烂了 / 我没新意 / 和别人一样 /我必须想新点子 / 真实事件写小说 / 历史题材 / 传记 / 回忆录 / 非虚构改编 / 叙事策略 / 通过谁的眼睛讲 /故事引擎 / story engine / 核心问题 / 小说在回答什么问题 / 中段失去方向 / 写到一半散了 / 故事没有主心骨"。不适用于：纯抒情散文与反结构实验小说（问题引擎合法缺席）；要求严格 1:1 复刻真实的新闻报道；概念已定之后的结构诊断（见 story-structure）；写作习惯、心理状态等作者培养问题。与 story-planning 交接：用户第一句话只有模糊 idea / 素材 / 引擎不清 → 本 Skill；概念已定、要做节拍表/工作流 → story-planning。 |
| design-story-foundation | `.agent/skills/design-story-foundation/SKILL.md` | 在正式规划前固化作品根设定，按固定三级章节树生成可比较的前期设计候选。用户仍在单文档前期设计阶段时使用；不写正文、不落库、不替用户定稿。不适用于合并多案（归 merge-story-candidates）或正式规划落库（归 plan-story）。 |
| merge-story-candidates | `.agent/skills/merge-story-candidates/SKILL.md` | 把多份已完成的前期设计候选逐章串行统合成一份新候选，一级章节一个 fresh 代理，权威顺序固定为根设定优先。用户明确要求综合多案时使用；不生成候选、不做机械门校验、不改前期设计 SoT。 |

## 4 结构与规划

| skill_name | skill_file | skill_description |
|---|---|---|
| foreshadow-payoff | `.agent/skills/foreshadow-payoff/SKILL.md` | 小说写作的伏笔与回收方法：把显著元素登记成债务、把铺垫埋得自然、让兑现从已埋细节生长出来。当用户说"埋了没收""线索失踪""伏笔太突兀""这个细节是装饰还是债务""契诃夫之枪怎么用""伏笔怎么分层""兑现时间表"，或明确在谈埋/收/铺垫链、特殊人物出场前的台阶时激活。关键 trigger："伏笔" / "回收" / "铺垫" / "契诃夫之枪" / "chekhov's gun" / "foreshadow" /"线索失踪" / "埋了没收" / "承诺不兑现" / "前面挖的坑没填" / "删除测试" / "伏笔分层" /"短期伏笔 / 中期伏笔 / 长期伏笔" / "兑现时间表" / "伏笔台账" / "修楼梯" / "Hitchcock 变体" /"显眼的凶器" / "预暴露的伏笔" / "前后呼应" / "高潮从天而降（欠债未兑）"。不适用于：仅问「高潮怎么写」「反转怎么设计」「大场面怎么拍」而无埋/收/契诃夫语境（归 scene-craft / story-structure / story-ending）；散文/随笔（无情节承兑机制）、纯意识流/氛围小说（无情节闭环压力，元素出现又消失是合法的）、解构/反小说（刻意让伏笔不兑现正是其目的）、需要大场面直接冲击的灾难/战争场景、1000 字以下超短篇（没有埋设与生长的空间；1500 字以下不需要分层）。与 scene-craft 交接：单场景高潮执行（使命/镜头/进出）归 scene-craft；本 Skill 只管债务登记与兑现链。与 story-ending 交接：终局姿态与倒推收束归 story-ending；本 Skill 只保证前文债务可兑。 |
| narrative-momentum | `.agent/skills/narrative-momentum/SKILL.md` | 写或改长篇小说、网文连载、章节体故事遇到动力问题时激活：情节推不动、事件之间接不上、中段塌陷读者弃读、章末平淡翻不下去、高潮不爆。三台发动机：给事件接因果推力链（造势）、沿途埋小奖励（金币）、在断点挂未解问题（内悬念）。关键 trigger：造势 / 势 / 推力 / 情节推不动 / 情节跳跃 / 高潮不爆 / 中段无力 /中段塌陷且读者弃读 / sagging middle / 读者弃读 / 金币 / 沿途埋金 / gold coin /章末钩子 / 段末悬念 / 卷末悬念 / internal cliffhanger / 内悬念 / 钩子 / 怎么让读者翻下去 / 付费点钩子。（裸「中段塌陷」无弃读/钩子语境时先查 story-structure）不适用于：抒情散文与诗（没有叙事路径和断点）；意识流、反悬念的实验叙事（靠情绪流，不靠势与钩子）；新闻报道（倒金字塔结构）。沿途埋金不适用于 1 万字以下短篇（没有中段可埋）；造势与断点钩子对短篇仍适用（势链要短要密）。与 story-structure 交接：中段塌陷若来自里程碑错位/赌注不升，先查 story-structure；本 Skill 只管读者动力（势/金币/钩子）。 |
| plan-chapter | `.agent/skills/plan-chapter/SKILL.md` | 根据已确认规划、叙事状态和冻结事实生成下一章结构细纲草稿。正文生成前需要明确章目标、事件因果、出场实体、伏笔动作和章末钩子时使用；不写正文、不读取目标章答案。书级设定/大纲/装配归 plan-story；本 Skill 是 section_type=fine_outline 的唯一写入方（经 persist_planning.py --owner-skill plan-chapter）。 |
| plan-story | `.agent/skills/plan-story/SKILL.md` | 按正式 schema 生成或修订作品设定包、大纲、知识卡、状态和装配草稿。前期方向已由用户选定并进入正式规划，或续作需要调整规划时使用；不写正文，未确认产物不进入生成上下文。单章 fine_outline（含 writer 硬依赖字段）只归 plan-chapter；本 Skill 不得写入 section_type=fine_outline。 |
| story-ending | `.agent/skills/story-ending/SKILL.md` | 小说收尾阶段激活。当用户问"结尾怎么写"、担心烂尾、觉得最后几章拖尾或结尾无力、在开放式与闭合式结局之间拿不定主意、想从终局倒推前文、系列小说要协调本集结局与系列结局、或需要判断读者读完是"被关起来"还是"被打开"时使用。关键 trigger："怎么结尾" / "收尾" / "烂尾" / "拖尾" / "结尾无力" / "结尾策略" / "结局设计" /"倒推" / "从最后一章写起" / "chain of execution" / "完成还是打开" / "收束还是扩展" /"戛然而止" / "意犹未尽" / "被关起来" / "被打开" / "ending"。不适用于：以"无结尾"本身为表达的开放实验文学与反叙事解构作品、短抒情诗与散文、刻意反高潮的平铺直叙、必须闭环的事务性场景（合同签署、手术完成、机器启动）与必须收束的紧急信息（"立即撤离"类）。与 foreshadow-payoff 交接：收束前未兑伏笔债归 foreshadow-payoff；终局姿态与倒推路径归本 Skill。与 story-structure 交接：全书里程碑/四箱/中段结构成因归 story-structure；只谈收尾姿态用本 Skill。与 narrative-momentum 交接：结尾前金币/势/弃读归后者。 |
| story-planning | `.agent/skills/story-planning/SKILL.md` | 激活场景：用户在规划新故事、做故事蓝图或节拍表；纠结"凭灵感写还是按计划写"；有一个想法想变成完整故事；凭灵感写作卡在中段、故事乱、不知道接下来写什么；写完一稿想诊断故事哪里出了问题。关键 trigger："节拍表 / beat sheet / 什么是节拍表 / 节拍表是什么 / 故事大纲 / 故事规划 / story planning /故事蓝图 / 写之前要做什么 / 我应该怎么规划故事 / 灵感写作 / pantsing / 计划写作 / plotting / 凭灵感写 /凭感觉写 / 短篇怎么开始 / 小说怎么写 / 故事写作步骤 / 我想写小说 / 我有一个想法 / 怎么把想法变成完整故事 /故事没头没尾 / 卡在故事中段 / 接下来写什么 / 写到第 5 稿还在找故事"。不适用于：故事结构本身的定义（四箱、六里程碑见 story-structure）；场景、对话、叙述层面的改稿技巧；作者日常写作习惯与心态调节；非虚构写作；实验性非线性写作（节拍表假设线性）。与 concept-design 交接：只有模糊 idea、引擎不清 → concept-design；概念已定、要节拍表与工作流 → 本 Skill。 |
| story-structure | `.agent/skills/story-structure/SKILL.md` | 激活场景: 为长篇/中篇小说或剧本搭结构骨架、改稿时做结构诊断、判断开头与关键节点该放在哪、处理"中段塌陷""故事没启动""赌注不升""开头抓不住读者"等结构问题、写前确认短中长篇体裁。关键 trigger: "故事结构 / 四箱 / 三幕 / 6 里程碑 / first plot point / FPP / 第一情节点 / midpoint / 中点 /煽动事件 / inciting incident / 触发事件 / Setup 段 / 开篇五件事 / 中段塌陷 / 赌注没升 / up the ante /不知道怎么开头 / 想不到第一句 / 开头抓不住读者 / 开头没冲突 / 主角的日常没被打破 / 开头像介绍背景 /短中长篇体制 / 主角转主动 / 主角太英雄 / 故事节奏 / pinch point / 夹点 / 故事没启动"。不适用于: 非叙事内容(纯数据/公文)、没有可识别人物主角线的纯设定集、意识流与抒情散文(不靠外部事件推动)、新闻导语与学术摘要类非虚构开头、单场景内的微观写作(归 scene-craft)、作者写作习惯与心理状态(作者培养类)。与 narrative-momentum 交接：「中段塌陷」的结构成因（里程碑/赌注/四箱）归本 Skill；弃读、章末钩子、势链/金币/内悬念归后者。 |

## 5 正文写作与呈现

| skill_name | skill_file | skill_description |
|---|---|---|
| character-design | `.agent/skills/character-design/SKILL.md` | 小说写作的人物设计方法：用 7 变量全维度建角色，用表层/内层/深层三层信息让角色立体，用内在恶魔给角色驱动力和角色弧，用一句话测试给人物选扁平/圆形形态，把人物站在叙事原型上做反转。激活场景：创建新角色（包括"AI 协作建角色，给我一份清单"）、角色库管理（很多角色要系统化区分）、角色不鲜明/脸谱化/一维、角色感觉飘或假、角色工具人没驱动力没弧、读者不关心主角、两个角色撞型、群像分不清、配角和主角怎么分配深度、人物太单薄或太符号化、想用原型/神话母题但不想俗套、网文主角类型设计、历史人物重写、主题象征想用但用力过猛。关键 trigger："角色设计 / 角色构建 / 角色要素 / character profile / 角色 sheet / 角色清单 / 角色怎么写 /角色背景 / 角色目标 / 角色动机 / 7 变量 / 角色旋钮 / 角色维度 /立体 / 角色深度 / 角色层次 / 表层 / 内层 / 深层 / 3 维角色 / 一维 / 主角是 1 维 / 怎么让角色活 /扁平 / 圆形 / flat / round / 一句话概括 / 人物太单薄 / 如何让人物丰满 /内在恶魔 / inner demon / 内在冲突 / 角色弧 / 工具人 / 角色是搬运工 / 没有驱动力 / 没有灵魂 /为什么读者不关心我的主角 / 原型 / archetype / 刻板印象 / stereotype / 人物塑造 / 主题象征 / symbol /中国小说原型 / 本土原型 / 东方母题 / father horst / 墙不只是墙 / 象征不必是钹 /如何用原型又不套路 / 用原型别让原型用你"。不适用于：对真实人物的全面评价（道德问题，不是方法问题）；无人物的纯信息文本；后现代解构作品故意反原型、反母题时（原型定位合法缺席）。与 character-presentation 交接：7 变量/弧线/扁圆/原型归本 Skill；定型后的登场细节、关系网、反常瞬间呈现归 character-presentation。与 dialogue-craft / narration-pov 交接：正文对话声音与视角执行归后两者，本 Skill 不写对话课。 |
| character-presentation | `.agent/skills/character-presentation/SKILL.md` | 写小说时要把人物呈现给读者看，而不是讲给读者听，遇到这些情况激活：人物登场段读起来像性格形容词清单，用了勇敢、热情、冷酷等抽象词但读起来假；人物扁平、脸谱化、群像分不清；次要人物只有 200 字登场空间不知道怎么让人记住；情节靠巧合推动，主角无故倒霉；人物没戏、该转变但读者看不到转变；想知道"如何显示人物"而不是"告诉"。关键 trigger："细节马赛克 / mosaic of detail / 人物立体 / 人物脸谱化 / 登场段 /性格形容词 / show not tell / status details / Tom Wolfe / 网文主角人设 /性格碰撞 / 性格即命运 / 反常即戏 / 反常瞬间 / 关系网 / 隐藏关系 / 人物很立体 /比现实更真实 / 人物让我看到了看不到的东西 / 过程发现 / 人物自己说话了"。不适用于：人物变量设计、人物弧线与原型定位、扁圆人物一句话测试（归 character-design）；纯意识流、极简主义与人物作为思想载体的抽象哲学小说；真实人物之间的理解问题（那是心理学不是文学）；非虚构写作（纪实作品人物的话必须基于事实）。与 dialogue-craft 交接：说话方式、句长、口头禅、同一声音诊断、遮住名字测试归 dialogue-craft；本 Skill 只管登场呈现、关系网、反常瞬间与"过程发现"叙事。与 character-design 交接：建角变量与弧线归后者；定型后的场景内呈现归本 Skill。 |
| dialogue-craft | `.agent/skills/dialogue-craft/SKILL.md` | 激活场景：写或改小说对话——用户说"我对话写不好"、"对话太书面、像论文答辩"、"对话全是 X 说 Y 说"、"所有角色说话一个声音"、"对话推动不了情节"、"不知道什么时候用对话什么时候用叙述"、"对话只是在传递信息"、"对话没张力"、"对话写得像答辩"、"写了一整章对话情节没推进"、"权力博弈场景对话没张力"、"对话怎么暴露人物、怎么改变权力关系"。关键 trigger："对话写不好"、"对话太书面"、"对话像答辩"、"什么时候用对话"、"对话一个声音"、"对话推动情节"、"X说Y说"、"对话没张力"、"对话太碎/太满"、"对话即行动"、"dialogue as action"、"对话和引语的区别"、"dialogue vs quote"、"对话暴露人物"、"对话改变权力"、"小说对话技巧"。不适用于：说明文/议论文；访谈记录与会议实录（非虚构对话是转录，不是小说）；剧本（两书冲突保留：布兰德认为对白即剧本全体、无需判断何时用；克拉克源单元声明适用于写剧本；见 references/boundaries-and-pitfalls.md 适用范围节）；纯抒情与内心独白（规则不同，见 narration-pov）；无对话的纯动作戏（见 scene-craft）；辩论稿与演讲稿（目标是说服，不是"做事"）；用户整篇不会写（那是 story-planning 的活）；对话只是其中一部分、想整体优化（先把稿子放一边、隔夜重读做整篇优化，不在对话层面修）。与 character-presentation 交接：登场呈现与"过程发现"归后者；说话方式、句长、口头禅、同一声音诊断归本 Skill。 |
| expand-scene | `.agent/skills/expand-scene/SKILL.md` | 在既有场景内补充动作链、对话潜台词、感官细节和环境互动。用户认为某个场景过薄并明确要求扩写时使用；不新开场景、不改落点、不夹带新设定。点名改情节/翻案归 rewrite-selection；只修语病/标点/节奏归 polish-prose；AI 味须先 diagnose-ai-flavor，本槽不得绕过。 |
| narration-pov | `.agent/skills/narration-pov/SKILL.md` | 中文小说写作中选择视角、叙述立场和叙述模式时使用。激活场景：选视角人物并决定向读者透露多少信息；想揭示封闭组织、社区、制度的荒谬而不说教；想写开放式结局、暧昧关系、命运类故事让读者回味；想避免作者跳出来下判断、给简单答案；决定何时暂停主线去做反思、插叙、独白、闪回并落回主线。关键 trigger：视角、POV、全知、限制视角、外来者视角、局外人、叙述立场、怀疑、说教、太直白、开放式结局、不确定性、留白、插叙、倒叙、意识流、内心独白、主线太平、折线落不回去、主线与折线、折线、汽笛站、卡夫卡式、fish out of water、broken line。不适用于：无叙事时间的纯抒情诗或散文；千字以内的单场景小品；推理悬疑等结尾必须给出确定答案的作品；需要明确价值观引导的儿童文学；需要明确立场的议论文、社论；纯对话剧本（对话的功能见 dialogue-craft）。与 theme-and-stance 交接：远距荒诞外来者（布尔加科夫式撒旦访莫斯科）的完整案例与幽默结构归 theme-and-stance；本 Skill 只保留外来者切入机制，案例见 references/outsider-entry.md 第三节指针。 |
| polish-prose | `.agent/skills/polish-prose/SKILL.md` | 修正候选或既有正文的错字、语病、标点、节奏和角色声音指纹（非规则级去 AI 味）。用户只要求改善表达层时使用；不得改变情节事实、场景结构或对白语义。场景加厚归 expand-scene；点名改范围/翻案归 rewrite-selection；AI 味检测与修订归 diagnose-ai-flavor → revise-ai-flavor，本 Skill 不得自称去 AI 味入口。 |
| prose-craft | `.agent/skills/prose-craft/SKILL.md` | 中文小说的语言与修辞领域：写稿或改稿时调整句子层与段落层的文本。激活场景：段落读起来单调催眠，句长或主谓位置需要诊断；满纸抽象，读者既看不见也摸不着，怀疑卡在官僚话、套话、公文腔；重大场景（死亡、战争、重病）用力过猛，或日常场景没有文气；抒情太直白变滥情；想用白描立人物；文本或人物温度不稳、没有辨识度；风格漂移，想逐根杠杆诊断声音。关键 trigger："句法节奏" / "主谓先行" / "右分支句" / "句长" / "模式转折" / "boom boom bang" / "翻译腔" / "抽象梯子" / "太抽象" / "能给我个例子吗" / "给我个例子" / "由抽象到具体" / "怎么写得有深意" / "用力过猛" / "修辞密度" / "克制" / "back off" / "show off" / "抒情" / "滥情" / "白描" / "基础体温" / "声音均衡器" / "graphic equalizer" / "风格漂移" / "风格诊断" / "找到自己的声音" / "三十个杠杆"。不适用于：诗歌；实验文学与故意打破语法的项目；翻译文本（应保留原语节奏）；纯动作戏（无抽象层与修辞校准需求）；公文、教科书、工具书、学术论文、商业文案等非叙事文体。与 show-and-omission 交接：「太抽象 / 读者看不见」若主要是情绪/性格标签堆叠，归后者做标签→场景；本 Skill 管句段修辞、句长、修辞密度与声音杠杆。 |
| rewrite-selection | `.agent/skills/rewrite-selection/SKILL.md` | 按用户意见重写指定段落或场景，并校验范围、事实锚和版本。用户明确点名修改范围时使用；范围外原文不动，不顺手改规划或知识卡。场景过薄只加厚归 expand-scene；只修表达层归 polish-prose；AI 味须先 diagnose-ai-flavor，本槽不得绕过。 |
| scene-craft | `.agent/skills/scene-craft/SKILL.md` | 小说场景执行方法：给每个场景定使命、定详略、定进出点、定镜头距离，把相邻场景排成节奏，再把拼装痕迹蒙蔽掉。用户建场景、改场景、诊断场景时激活："这个场景有什么用、场景散、小说拖、场景太慢、不知道该详写还是略写、字数安排不合理、过渡生硬、场景扁平、没画面感、全程中景、场景切换不自然、读者出戏、高潮没力"。关键 trigger："场景使命 / 场景任务 / scene mission / 晚进入 / 早退出 / enter late leave early /场景进入退出 / 场景节奏 / 场景紧凑 / 详写略写 / 字数安排 / 过渡 / 镜头距离 / 摄影机距离 /拉远推近 / 远景中景特写 / 鸟瞰 / 建立镜头 / cinematic distances / 没画面感 / 场景扁平 /全程中景 / 对质戏 / 对峙戏 / 群像戏 / 回忆与现实切换 / 突兀 / 不自然 / 拼装痕迹 / 蒙蔽 /读者出戏"。不适用于：整体篇章结构与里程碑（用 story-structure）、对话写法（用 dialogue-craft）、展示与留白的一般原则（用 show-and-omission）、视角选择与叙述模式（用 narration-pov）、没有场景概念的非虚构与诗歌散文、剧本台词部分、纯抒情独白与全程单一距离的意识流章节、三千字以下切不开档的极短篇。与 foreshadow-payoff 交接：有「埋了没收 / 契诃夫之枪 / 铺垫债」语境 → foreshadow-payoff；仅「这个场景高潮没力 / 进出点弱」→ 本 Skill。与 narrative-momentum 交接：跨场景章末钩子、弃读、势链归后者；单场景使命与排节奏归本 Skill。 |
| show-and-omission | `.agent/skills/show-and-omission/SKILL.md` | 激活场景：小说文本里情绪、氛围、性格被抽象标签堆出来（"她很悲伤""气氛阴森""他是个好人"），读者没有画面；写到极端情绪场景（崩溃、杀人后、噩耗、求爱）不知道心理怎么下笔；奇幻、梦境、超现实情节写得假、读者出戏；对话和动作看着平淡，扛不出第二层意思；想藏住两个人之间的秘密或暗流，不想明说；视角人物说出了自己不可能知道的信息；或者总怕读者看不懂，解释越写越多，读者仍说读不懂。关键 trigger："show don't tell" / "展示不说教" / "没有画面感" / "太抽象" / "形容词太多" /"心理描写怎么写" / "不写他感到，写他做什么" / "留白" / "飞白" / "冰山" / "写得假" / "出戏" /"imagination" / "magical realism" /"读者不信" / "藏着不写明" / "说得太满" / "视角穿帮" / "人物知道了不该知道的" / "信息差" /"读者读不懂" / "明明很显然" / "跳步" / "术语太多" / "why is this jargon"。不适用于：意识流作品里刻意的直接心理呈现（乔伊斯、伍尔夫式的美学追求）；第一人称主观独白和全知叙述者的合法评述；纪实写作和须符合科学逻辑的硬科幻；需要逻辑严密的悬疑推理与动作戏（反逻辑法不能用）；说明书、新闻导语、学术论文、儿童启蒙等只需明确传递信息的段落；写给同行的专业文献（术语是该有的）。与 prose-craft 交接：句长单调、修辞密度、风格杠杆诊断归 prose-craft。与 theme-and-stance 交接：抽象标签、极端情绪缺画面、视角穿帮归本 Skill；主题演示、作家立场、手软/心慈手狠归 theme-and-stance（含 show don't tell 主题层）。 |
| theme-and-stance | `.agent/skills/theme-and-stance/SKILL.md` | 中文小说的主题表达与作家立场的执行层：主题不由作者说出来，由人物在关键时刻的选择演示出来；立场不靠主题先行去安排，藏进环境与性格的碰撞里自然浮现；沉重题材不写成控诉、苦情或谩骂，用幽默建立与现实的关系；人物该受的苦，作者不能因为心软而放过。激活场景：主题写成说教、立场太直白；人物像作者传声筒、情节被安排去服务主题；沉重题材写得压抑、愤怒、读着难受；作者舍不得人物受苦、写到关键处手抖。关键 trigger："主题说教" "主题太直白" "主题先行" "席勒化" "莎士比亚化" "主题怎么表达""show don't tell 主题" "演示主题" "手软" "舍不得" "手抖" "心慈手狠" "狠瞬间""黑色幽默" "沉重题材" "太沉重了" "批判但不说教" "读着压抑" "布尔加科夫" "卡夫卡式幽默"。不适用于：非虚构/纪实/学术写作（主题表达方式不同）；寓言、童话、儿童文学（可以明说主题，也可以心慈不手狠）；纯喜剧写作（幽默本身就是目的）；大屠杀、重大灾难等纯悲剧庄重题材（慎用幽默，会显得轻佻）；主题尚未建立（先用 concept-design 做概念设计）。与 show-and-omission 交接：标签换场景、冰山留白、视角穿帮归 show-and-omission；主题演示、立场与手软/幽默结构归本 Skill。与 narration-pov 交接：外来者切入的荒诞/幽默距离与结构（含撒旦访莫斯科全文案例）归本 Skill；narration-pov 只保留 POV 侧外来者机制指针。 |
| write-next-chapter | `.agent/skills/write-next-chapter/SKILL.md` | 按已确认细纲、冻结事实和动态篇幅合同生成下一整章候选。作品需要续写下一章且输入合同完整时使用；不自行检索、不改规划、不把候选直接写入 Canonical。 |

## 6 检测、评分与诊断

| skill_name | skill_file | skill_description |
|---|---|---|
| adjudicate-quality-gate | `.agent/skills/adjudicate-quality-gate/SKILL.md` | 从不可变逐层回执构建 Gate 输入，并按父仓专题-04 的固定顺序产出 Gate A/B 终态与可核验 receipt。回放评测收集完逐样本脱敏结果、需要一个不可协商的通过/不通过裁决时使用；不评分、不改样本、不放宽阈值。 |
| check-content-consistency | `.agent/skills/check-content-consistency/SKILL.md` | 检查正文或细纲候选的结构、事实、角色状态、能力代价、伏笔和证据缺口。候选进入用户决策或独立评分前使用；只产检测报告，不修改候选。 |
| evaluate-frozen-replay | `.agent/skills/evaluate-frozen-replay/SKILL.md` | 编排细纲隔离回放：把参考作品冻结到 as_of 章号，跑三臂 planner、盲 detector 与双盲 judge，产出可审计的逐样本结果。需要验证知识或上下文方案对细纲质量是否有增益时使用；阻断未来信息、未授权来源和不可接受的候选流入生产。 |
| load-replay-reference-work | `.agent/skills/load-replay-reference-work/SKILL.md` | 在单个只读事务内从实验库装配正文回放的真实临时配置：来源证明、授权快照、目标 scaffold 拆分、冻结历史与预注册卡，写到仓库外临时文件。回放要从仓内合成夹具切到真实作品时使用；只 SELECT，不查询目标章正文，不把原书写进 Git。 |
| novel-diagnosis | `.agent/skills/novel-diagnosis/SKILL.md` | 激活场景：用户手里有一部写完或在写的小说，感觉不对劲但说不清哪里不对——"我的小说有什么问题"、"它缺什么"、"为什么被拒稿"、"虎头蛇尾/高开低走"、"中段疲软"、"人物写扁了"、"全是流水账没有峰值"、"读者很兴奋但没理解"、"收尾太硬"、"形式大于内容"；或要把自己的作品和参照作品比差距；或交付诊断/评论/书评结论前需要扫描一遍有没有空话。关键 trigger："诊断作品 / 小说体检 / 我的小说有什么问题 / 缺什么 / 为什么被拒 / 虎头蛇尾 /高开低走 / 中段疲软 / 流水账 / 写扁了 / 故事还是情节 / 后来呢 / 为什么 / 有时间没价值 /情节和人物谁赢 / 模式还是节奏 / 幻想还是预言 / 六便士 / 难懂 / 奇书 / 六核 / 七侧面 /圆桌 / 伪学者 / 怎么系统地看一部小说"。不适用于：请求写作技法而非找毛病；非虚构；纯新闻速报/菜谱等时间流即内容的对象；作者习惯/心理培养问题。症状已落到具体环节时不要停在本 Skill，按下表交接：结构/里程碑→story-structure；弃读/钩子→narrative-momentum；建角变量→character-design；登场呈现→character-presentation；对话声音→dialogue-craft；场景执行→scene-craft；标签画面→show-and-omission；句段修辞→prose-craft；POV 机制→narration-pov；主题/荒诞幽默→theme-and-stance；埋收债→foreshadow-payoff；idea/引擎→concept-design；节拍工作流→story-planning；收尾姿态→story-ending；AI 味→diagnose-ai-flavor（须先诊断）。 |
| optimize-content-quality | `.agent/skills/optimize-content-quality/SKILL.md` | 根据 score-content-quality 的独立评分，锁定最低质量维度并归因到 prompt、上下文或设定层，只出单变量改进建议。候选稳定不达标且需要定位改进来源时使用；不执行重生成、不改 rubric、不自行提交代码。 |
| replay-writer-gate | `.agent/skills/replay-writer-gate/SKILL.md` | 执行正文 A/B/C 三臂隔离回放：构造并校验三臂 WriterContext、跑写手与盲评、结算预算与 raw 租约，产出逐样本脱敏结果。需要用真实作品验证卡索引对正文质量是否有增益时使用；不产生 Gate 终态，不把原书正文写进仓库。 |
| score-content-quality | `.agent/skills/score-content-quality/SKILL.md` | 按独立 rubric 评分在线正文、正文回放或细纲回放，产出逐维分数、引文证据与理由。候选交付用户前或回放实验需要独立质量判断时使用；只评分不裁决——集合级通过/不通过归 adjudicate-quality-gate；不改候选、不放宽阈值。 |

## 7 去 AI 味与人感

| skill_name | skill_file | skill_description |
|---|---|---|
| capture-ai-flavor-cases | `.agent/skills/capture-ai-flavor-cases/SKILL.md` | 从已有作品或创作反馈中抽取可复核的 AI 味案例卡，保留来源哈希与位置并做来源重验证。需要反向积累人感样例、记录一次写作事故或批量回填既有作品时使用；不做标注确认与规则升格，不直接修改正文、范式或生产规则。 |
| diagnose-ai-flavor | `.agent/skills/diagnose-ai-flavor/SKILL.md` | 技能 3 诊断：对目标正文跑 active 规则库，产出带精确片段与证据的发现清单，检测完成自动落库。只查不改；没有本产物，revise-ai-flavor 拒绝启动。 |
| establish-voice-baseline | `.agent/skills/establish-voice-baseline/SKILL.md` | 技能 1 定基线：作品建立或新角色登场时，把已确认正文与作者样张产出的声音账做结构校验、grounding 门后版本化落库。不产正文；是修订门禁与前置预防的对照物。 |
| prevent-ai-flavor | `.agent/skills/prevent-ai-flavor/SKILL.md` | 技能 2 前置预防：生成前组装写作上下文合同——active 规则的负约束（附反例）加声音账的正样例与保护项。不碰正文，只供上下文组装消费。 |
| promote-ai-flavor-rule | `.agent/skills/promote-ai-flavor-rule/SKILL.md` | 把已标注的 AI 味案例卡沿 canonical→样例→规则候选→评测→激活的升格链推进，并负责降级。需要确认案例卡、投影四类样例、归纳规则候选、跑合同回放或审批激活时使用；不做案例采集与扫描，也不改正文。 |
| revise-ai-flavor | `.agent/skills/revise-ai-flavor/SKILL.md` | 技能 4 修订：在诊断产物与作者同意之上执行最小 patch，过硬门、复扫与成对选择校验，产出候选稿与审计报告。没诊断不启动；人不点头永远是候选。 |

## 8 候选主权与落库

| skill_name | skill_file | skill_description |
|---|---|---|
| confirm-knowledge-draft | `.agent/skills/confirm-knowledge-draft/SKILL.md` | 用户明确确认后把知识草稿翻成作品正式知识面，写入实体或关系、绑定知识库并迁移向量 owner。抽取或拆书产出的卡需要转正时使用；不处理正文候选、规划确认和冲突裁决。 |
| decide-candidate | `.agent/skills/decide-candidate/SKILL.md` | 据用户明确指令接受、合并或丢弃 Shadow 正文候选并更新 Canonical。仅主会话在用户决定后调用；知识卡归 confirm-knowledge-draft，规划归 plan-story。 |