Просмотр исходного кода

refactor: split CLAUDE.md into README.md (user manual) + slim SKILL.md (AI skill)

Rename CLAUDE.md to README.md as the user-facing manual, and keep SKILL.md
lean as the AI-loaded skill file. Removes ~26% redundant content from SKILL.md
(1260→926 lines) including:
- Duplicated quick-command table (scene routing already covers it)
- Evolution system internals (now only in README.md; SKILL.md keeps just the
  pre/post-write commands AI needs to run)
- Verbose decision-tree pseudocode in 深度问诊 and 大纲共创 (condensed to tables)
- ASCII dashboard template (kept the actionable trigger→action table)
- 一句话钩子标准 and 黄金三章 merged into 题材诊断

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
nonvioce 5 месяцев назад
Родитель
Сommit
e7558441f8
2 измененных файлов с 268 добавлено и 420 удалено
  1. 183 2
      README.md
  2. 85 418
      SKILL.md

+ 183 - 2
CLAUDE.md → README.md

@@ -1,10 +1,37 @@
 # novel-write — Claude Code 小说写作技能
 
 长中短篇小说写作技能,覆盖题材诊断→设定→大纲→写作→质检全流程。
-内置自优化引擎,同题材写作越写越好。
+
+**核心能力:**
+- **六条铁律** — 展示而非讲述、冲突驱动、悬念承上启下、爽点密度、类型框架内新鲜感、自动进化
+- **三根支柱** — 项目铁律(宪法级规则)+ 事件钩子账本(伏笔全生命周期)+ 情感矩阵(角色情感连贯性)
+- **四维引擎** — 爽点、笑点、代入感、反同质化,每章自动四维检查
+- **质检体系** — 五遍编辑评估(结构→角色→原创性→对话→文本)+ 自修正循环 + 章节审批门
+- **自优化进化** — 每次写作后自动进化提示词和质量阈值,同题材越写越好
+- **15 个题材** — 仙侠、玄幻、都市、恐怖、科幻、末世、无限流、游戏、奇幻、言情、轻小说、种田、地下城、修真、通用
+
+**前置依赖:** 本技能在 [Claude Code](https://claude.ai/code) 中运行,利用 Claude 的大语言模型进行小说创作。无需 GPU、无外部 API、完全本地运行。
 
 远程仓库: `ssh://git@数学.top:10022/nonvioce/novel-skill.git`
 
+---
+
+## 目录
+
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [对话示例](#对话示例)
+- [技能架构](#技能架构)
+- [进化系统](#进化系统)
+- [多用户 Git 共享](#多用户-git-共享含多设备)
+- [题材管理](#题材管理)
+- [全部 CLI 命令](#全部-cli-命令)
+- [关键文件参考](#关键文件参考)
+- [常见问题](#常见问题)
+- [参考来源](#参考来源)
+
+---
+
 ## 安装
 
 完全自包含,零外部依赖。内置 15 个中文题材配置文件。
@@ -76,6 +103,88 @@ target_words: 3000
 
 **用户不需要输入任何 git 或进化命令。** 所有 git pull、git commit、git push 由进化脚本自动完成。网络不通时自动降级为纯本地模式,不会报错中断。
 
+## 对话示例
+
+### 开新书
+
+```
+用户:开新书,我想写一本末世种田文
+Claude:先做题材诊断。五句话——
+  1. 类型:末世 + 种田 + 诡异(system-apocalypse × cozy × horror)
+  2. 核心卖点:...
+  ...
+  诊断通过。开始深度问诊——
+  第一问:核心类型是末世,子方向更偏向废土求生还是系统降临?
+```
+
+### 续写
+
+```
+用户:写第33章
+Claude:[自动运行 evolve.sh → git pull + compile]
+  → 加载项目铁律、细纲第33章、钩子账本、情感矩阵
+  → 加载末世题材最优提示词
+  → 写作...
+  → [自动运行 evolve.sh --project → 进化 → git push]
+```
+
+### 质检
+
+```
+用户:质检最近3章
+Claude:→ 执行五遍编辑评估
+  P1 结构编辑:...  P2 角色编辑:...  P3 原创性:...  P4 对话:...  P5 文本:...
+  综合评分 83 → 通过
+  一致性检查:无 S1/S2 问题 ✓
+  去 AI 味检查:通过 ✓
+```
+
+### 修改
+
+```
+用户:修改第33章,主角情绪太突兀
+Claude:→ 读取第32-34章 + 情感矩阵
+  → 定位情感跳变点 → 精确编辑
+  → 更新情感矩阵
+```
+
+### 更多触发词
+
+| 想做什么 | 说什么 |
+|---------|--------|
+| 批量写 | "批量写第40到45章" |
+| 风格模仿 | "分析风格 三体.txt" |
+| 导入已有书 | "导入小说 我的书.txt" |
+| 全书改名 | "改名 张三 李四" |
+| 查看数据 | "仪表板" |
+| 新建角色 | "添加角色 王五" |
+| 调整大纲 | "调整大纲" |
+
+## 技能架构
+
+本仓库包含两个核心文件,各司其职:
+
+```
+novel-skill/
+├── README.md              # 本文件,用户手册(给人看)
+├── SKILL.md               # 技能主文件,Claude Code 加载(给 AI 看)
+├── scripts/               # 进化引擎脚本
+│   ├── evolve.sh          # Linux/macOS 进化编排器
+│   ├── evolve.ps1         # Windows PowerShell 进化编排器
+│   ├── prompt_evolver.py  # 提示词遗传进化
+│   ├── quality_tuner.py   # 质量阈值自适应
+│   ├── pattern_mine.py    # 写作模式挖掘
+│   ├── feedback_collector.py  # 多维反馈收集
+│   ├── event_store.py     # 事件溯源引擎
+│   ├── seed_extractor.py  # 内置15题材种子提取
+│   └── utils.py           # 共享工具
+├── genres/                # 内置15题材配置文件
+├── evolution/             # 进化输出数据
+└── docs/                  # 设计文档(如有)
+```
+
+**原理:** Claude Code 加载 `SKILL.md` 获取写作指令。`SKILL.md` 只包含 AI 需要的写作规则和流程,不包含用户手册中的进化系统内部架构、CLI 命令参考等内容。用户参考 `README.md` 了解安装、配置和手动操作。
+
 ## 进化系统
 
 ### 架构
@@ -304,7 +413,7 @@ python3 scripts/pattern_mine.py mine --project /path/to/novel
 | 文件 | 用途 |
 |------|------|
 | `SKILL.md` | 技能主文件,Claude Code 加载此文件获取写作指令 |
-| `CLAUDE.md` | 本文件,项目进度和使用说明 |
+| `README.md` | 本文件,用户手册 |
 | `scripts/evolve.sh` | 进化编排器入口 (Linux/macOS),自动检测项目/题材 |
 | `scripts/evolve.ps1` | 进化编排器入口 (Windows PowerShell),功能与 .sh 完全相同 |
 | `scripts/prompt_evolver.py` | 岛屿模型 + 遗传算法 + 早停 + 灭绝 |
@@ -315,6 +424,78 @@ python3 scripts/pattern_mine.py mine --project /path/to/novel
 | `scripts/pattern_mine.py` | MAP-Elites 写作模式挖掘 |
 | `scripts/utils.py` | 共享工具(路径解析/题材映射/持久化)|
 
+## 常见问题
+
+### Claude Code 提示"技能未找到"
+
+确认技能已安装到正确路径:
+- Linux/macOS: `~/.claude/skills/novel-write/SKILL.md`
+- Windows: `%USERPROFILE%\.claude\skills\novel-write\SKILL.md`
+
+如果使用软链接,确保链接目标存在且可读。
+
+### git pull 失败
+
+进化脚本在网络不通时自动降级为纯本地模式,不影响写作。手动重试:
+
+```bash
+cd ~/.claude/skills/novel-write && git pull
+```
+
+### 进化数据没有更新
+
+```bash
+# 从事件重建编译产物
+bash scripts/evolve.sh --project /path/to/novel --compile
+```
+
+如果题材尚无任何事件,compile 会自动从内置种子初始化。
+
+### 新增题材后进化不生效
+
+1. 确认题材配置文件在 `genres/` 目录下,格式为 YAML frontmatter + Markdown body
+2. 运行 `python3 scripts/seed_extractor.py --genre {新题材}` 初始化题材进化目录
+3. 写下一章时,技能会自动识别 `项目铁律.md` 中的 `genre` 字段并匹配
+
+### 换新设备后如何恢复
+
+1. 克隆仓库到技能目录
+2. 克隆你的小说项目
+3. 首次写作时 `evolve.sh` 自动检测缺失的编译产物,从事件重建
+4. 无需手动操作
+
+### 小说项目目录可以放在哪里
+
+任意位置。写作时告诉 Claude Code 项目路径即可。推荐放在独立的工作目录而非技能目录内。
+
+### 如何贡献新题材
+
+1. 在 `genres/` 目录下创建新 `.md` 文件,参考现有题材格式
+2. 运行 `python3 scripts/seed_extractor.py --genre {新题材} --show` 预览提取结果
+3. 运行 `python3 scripts/seed_extractor.py --genre {新题材}` 初始化进化目录
+4. 提交 PR,只包含 `genres/` 下的新文件和进化事件文件
+
+题材配置文件格式:
+```yaml
+---
+genre_id: xinxitai
+display_name: "新题材"
+chapter_types: ["类型A", "类型B", "过渡", "回收"]
+pleasure_points: ["爽点1", "爽点2", "爽点3"]
+seeds:
+  writing: |
+    写作规则提示词...
+  revision: |
+    修稿规则提示词...
+  quality_check: |
+    质检标准提示词...
+  outline: |
+    大纲规则提示词...
+  hook_management: |
+    伏笔管理提示词...
+---
+```
+
 ## 参考来源
 
 - [InkOS](https://github.com/Narcooo/inkos) — 题材配置、37维质检、伏笔全生命周期

+ 85 - 418
SKILL.md

@@ -330,123 +330,74 @@ description: |
 
 **坏题材特征:** 设定大事件弱、题材混杂消费点不清、主角只是"特别"但不被迫行动、全靠后期反转前 10 章跑不动
 
----
-
-## 深度问诊(开新书专用)
+### 一句话钩子标准
 
-开新书时,在题材诊断通过后、进入设定之前,必须执行深度问诊。这是一对一的迭代式提问流程,目标是达到共享理解——不只是收集信息,而是确保每个关键决策都被充分审视。
-
-### 问诊铁律
+必须包含:**谁 + 在什么异常局面中 + 因为什么 + 必须做什么 + 最吸引人的点是什么**
 
-1. **一次只问一个问题。** 不列清单、不堆选项,让用户逐一思考。
-2. **遍历决策树。** 每个回答可能引出分支问题,穷尽当前分支后再进入下一主题。
-3. **先推荐再问。** 每个问题都附带推荐答案和理由,用户可以直接确认或反驳。
-4. **解决依赖再前进。** 如果当前决策依赖未解决的问题,先回溯解决依赖。
-5. **到达共享理解才结束。** 不是"问完了",而是"双方对答案达成了共识"。
-
-### 问诊决策树(按顺序遍历)
-
-**第一层:类型与读者**
-
-```
-起点问题:"这个故事的核心类型是什么?"
-
-如果用户说了一个大类(如"玄幻")→ 追问子类型:
-  "玄幻之下有很多子方向——是传统修仙、系统流、异界穿越、还是洪荒?你心里偏向哪个?"
-  推荐:根据用户之前描述的元素,推荐最匹配的子类型。
-
-如果用户说了子类型 → 追问读者预期:
-  "这个类型的读者进来看的第一眼期待是什么?你的故事在哪些地方满足这些期待,在哪些地方打破它们?"
-  推荐:列出该类型的 3-5 个核心读者期待,逐条确认。
-
-如果用户说"融合类型"或"XX × XX" → 追问融合比例:
-  "主类型和融合类型的比例大概是多少?70/30?50/50?主类型决定基本盘,融合类型决定差异化。"
-  推荐:建议主流类型占 60-70%,保证基本盘不丢。
-```
+好例子:
+- "被献给河神的少女,发现这是她唯一的修仙之路。"
+- "58 岁男人醒来成了万人嫌的真千金,决定用爹味整顿贵族圈。"
+- "攻略成功后离开系统世界的女配,被前夫花 500 万雇回来二次攻略他。"
 
-**第二层:卖点与差异化**
+坏例子:
+- "一个关于成长与友情的故事。"(太模糊)
+- "在广阔的奇幻大陆上……"(世界观介绍,不是钩子)
 
-```
-起点问题:"如果只能用一句话向读者推荐这本书,那句话是什么?"
-
-如果一句话钩子不符合标准(缺元素)→ 逐元素追问:
-  - 缺"谁":主角的什么特质让读者想追随?
-  - 缺"异常局面":什么让这个局面不普通?
-  - 缺"必须做什么":什么在逼迫主角行动?不行动的代价是什么?
-  - 缺"最吸引人的点":读者听完后主动问"然后呢?"的东西是什么?
-  推荐:每个元素给 2-3 个选项,让用户选或给出自己的答案。
-
-如果一句话钩子合格 → 追问差异化:
-  "有没有一本已有的书和你的故事很接近?如果有,你的故事和它最大的不同是什么?"
-  推荐:帮用户找到最接近的对标作品,然后逐条对比差异。
-
-如果找不到差异化 → 追问信息增量:
-  "你的个人经验、专业知识、或独特视角中,有什么可以注入这个故事?"
-  推荐:从用户背景中挖掘独特的"知识叙事"素材。
-```
+### 黄金三章
 
-**第三层:主角设计**
+前三章是成交区,不是铺垫区。必须让读者愿意追更。
 
-```
-起点问题:"主角是一个什么样的人?"
+**第一章:** 主角登场 + 异常局面落地 + 第一个麻烦砸下来
+**第二章:** 卖点展开 + 冲突升级 + 主角开始主动反应
+**第三章:** 明确方向 + 建立追更预期 + 章末拉一把
 
-追问链(按顺序):
-  1. "主角最想要什么?(核心愿望)" → 推荐:必须是具体且迫切的,不是"变强"这种模糊目标
-  2. "为什么是现在?(触发事件)" → 推荐:什么改变了,让主角不能继续维持现状?
-  3. "主角最大的缺陷是什么?(神圣缺陷)" → 推荐:不是"太善良了"这种假弱点,而是真正阻碍主角的错误信念或性格缺陷
-  4. "读者的代入锚点是什么?" → 推荐:主角的哪个特质/处境能让目标读者在 3 秒内产生"这就是我"的感觉?
-  5. "主角的行为驱动力是什么?" → 推荐:恐惧?欲望?责任?复仇?——选一个作为核心驱动力
+**前三章禁止:**
+- 3 章还在交代背景
+- 3 章没讲清主角需要做什么
+- 3 章只有情绪没有事件
+- 3 章只靠信息维持,局面没有变化
 
-如果主角设定模糊 → 用对比法追问:
-  "如果 XX(同类型经典主角)遇到你故事里的第一个麻烦,他会怎么做?你的主角会怎么做?区别在哪?"
-```
+字数节奏:前 300-500 字给抓手 → 前 1500-3000 字展示卖点 → 前 6000 字让读者知道主角是谁、遇到什么、卖点是什么、为什么想继续看
 
-**第四层:世界观硬核**
+---
 
-```
-起点问题:"这个世界和现实世界最大的不同是什么?"
+## 深度问诊(开新书专用)
 
-追问链:
-  1. "这个不同的规则是什么?" → 推荐:规则必须能一句话说清,且能直接生成事件
-  2. "这个规则的上限和下限是什么?" → 推荐:力量体系必须有天花板和代价,无限升级 = 无限无聊
-  3. "这个规则对普通人的生活产生了什么影响?" → 推荐:好的世界观不是说明书,而是体现在日常细节中
-  4. "主角在这个规则中的位置是什么?" → 推荐:初始位置(低/特殊/边缘)决定故事走向
+题材诊断通过后、进入设定之前,必须执行。一对一迭代式提问,一次只问一个问题,先推荐后确认。
 
-如果世界观涉及力量体系 → 追问:
-  "力量体系的代价是什么?使用力量有什么限制?" 
-  推荐:代价比力量本身更有故事性。每次使用力量都应该推动剧情或揭示角色。
-```
+### 问诊铁律
 
-**第五层:节奏与长度**
+1. **一次只问一个问题。** 不列清单,让用户逐一思考。
+2. **遍历决策树。** 穷尽当前分支后再进入下一主题。
+3. **先推荐再问。** 每个问题附带推荐答案和理由。
+4. **解决依赖再前进。** 当前决策依赖未解决的问题时,先回溯。
+5. **到达共享理解才结束。** 不是"问完了",而是"达成了共识"。
 
-```
-起点问题:"你计划写多少字?"
+### 五层决策树
 
-如果用户不确定 → 追问:
-  "这个故事的核心冲突需要多大的篇幅才能充分展开?"
-  推荐:根据类型和卖点给出字数建议——短篇 3-10 万字、中篇 10-30 万字、长篇 50-300 万字
+| 层 | 主题 | 起点问题 | 追问要点 |
+|---|------|---------|---------|
+| 1 | 类型与读者 | 核心类型是什么? | 子类型方向 → 读者期待(满足哪些/打破哪些) → 融合比例(建议主流占 60-70%) |
+| 2 | 卖点与差异化 | 一句话向读者推荐,那句话是什么? | 钩子四要素补全(谁/异常局面/必须做什么/吸引点) → 对标作品对比 → 信息增量来源 |
+| 3 | 主角设计 | 主角是什么样的人? | 核心愿望(必须具体迫切) → 触发事件(为什么是现在) → 神圣缺陷(非假弱点) → 代入锚点 → 核心驱动力(恐惧/欲望/责任/复仇) |
+| 4 | 世界观硬核 | 世界和现实最大的不同是什么? | 核心规则(一句话说清) → 上限/下限/代价 → 对普通人的影响 → 主角在规则中的位置 |
+| 5 | 节奏与长度 | 计划写多少字? | 篇幅建议(短篇 3-10 万/中篇 10-30 万/长篇 50-300 万) → 高潮数量与位置 → 章字数 + 更新频率 |
 
-如果用户说了字数 → 追问:
-  "在这个篇幅里,几个大高潮?分别大概在什么位置?"
-  推荐:每 30-50 章一个大高潮,先确定高潮位置再倒推章节节奏。
+### 主角模糊时的对比追问
 
-追问更新频率和章字数:
-  "计划每章多少字?每天更新几章?"
-  推荐:网文单章 2000-4000 字,日更 1-2 章。实体书单章可更长。
-```
+"如果 XX(同类型经典主角)遇到你故事里的第一个麻烦,他会怎么做?你的主角会怎么做?区别在哪?"
 
 ### 问诊结束条件
 
-全部五层遍历完毕,且满足:
-- 一句话钩子通过了"谁+异常局面+必须做什么+吸引点"四要素检查
-- 主角的神圣缺陷已经明确(不是假弱点)
-- 核心冲突不是模糊的"成长"而是具体且迫切的
+- 一句话钩子通过"谁+异常局面+必须做什么+吸引点"四要素检查
+- 主角的神圣缺陷已明确(不是假弱点)
+- 核心冲突具体且迫切(不是模糊的"成长")
 - 世界观至少有一个"只在这个世界才成立"的规则
 - 用户对字数、节奏、更新频率有明确预期
 
 ### 问诊输出
 
-问诊结束后,将所有决策写入 `设定/题材定位.md`,格式如下:
+将决策写入 `设定/题材定位.md`:
 
 ```markdown
 # 题材定位
@@ -488,39 +439,6 @@ description: |
 
 ---
 
-## 一句话钩子标准
-
-必须尽可能包含:**谁 + 在什么异常局面中 + 因为什么 + 必须做什么 + 最吸引人的点是什么**
-
-好例子:
-- "被献给河神的少女,发现这是她唯一的修仙之路。"
-- "58 岁男人醒来成了万人嫌的真千金,决定用爹味整顿贵族圈。"
-- "攻略成功后离开系统世界的女配,被前夫花 500 万雇回来二次攻略他。"
-
-坏例子:
-- "一个关于成长与友情的故事。"(太模糊)
-- "在广阔的奇幻大陆上……"(世界观介绍,不是钩子)
-
----
-
-## 黄金三章
-
-前三章是成交区,不是铺垫区。必须让读者愿意追更。
-
-**第一章要做:** 主角登场 + 异常局面落地 + 第一个麻烦砸下来
-**第二章要做:** 卖点展开 + 冲突升级 + 主角开始主动反应
-**第三章要做:** 明确方向 + 建立追更预期 + 章末拉一把
-
-**前三章禁止:**
-- 3 章还在交代背景
-- 3 章没讲清主角需要做什么
-- 3 章只有情绪没有事件
-- 3 章只靠信息维持,局面没有变化
-
-字数节奏:前 300-500 字给抓手 → 前 1500-3000 字展示卖点 → 前 6000 字让读者知道主角是谁、遇到什么、卖点是什么、为什么想继续看
-
----
-
 ## 风格模仿
 
 将参考文本的风格特征系统化地导入当前作品的写作中。
@@ -556,105 +474,39 @@ description: |
 
 ## 大纲共创(大纲阶段专用)
 
-创建大纲时,必须执行大纲共创流程。与深度问诊一样,这是一对一的迭代式提问——一次一个问题,推荐先行,遍历决策树,到达共享理解后才开始写章纲。
+一对一迭代式提问,一次一个问题,先推荐后确认。全书结构→卷纲→细纲,上层未定不跳细节。
 
 ### 共创铁律
 
-1. **先确认全书结构,再细化卷纲,最后才写细纲。** 不在上层未定时就跳入细节。
-2. **一次只问一个层次的问题。** 不要同时讨论全书结构和某章的爽点类型。
-3. **每个决策都附带推荐。** 基于题材定位和类型惯例给出建议,用户可以确认或反驳。
-4. **反向验证。** 每确定一个卷纲,反向检查它是否服务于全书核心冲突。
-5. **不满不写。** 用户对大纲的每个关键节点都表示认可后,才进入细纲写作。
+1. **先全书再卷纲最后细纲。** 不跳层。
+2. **一次只问一个层次。** 不同时讨论全书结构和章爽点。
+3. **每个决策附带推荐。** 基于题材定位和类型惯例。
+4. **反向验证。** 每卷纲反向检查是否服务于全书核心冲突。
+5. **不满不写。** 关键节点用户认可后才写细纲。
 
-### 共创决策树
+### 三层决策树
 
-**第一层:全书结构**
-
-```
-起点问题:"这个故事分为几卷?每卷的核心任务是什么?"
-
-如果用户不确定卷数 → 推荐:
-  "根据你的目标字数 {N} 万字和类型惯例,建议分为 {X} 卷,每卷约 {Y} 万字。
-   第一卷通常负责:建立世界观 + 主角入局 + 第一个小高潮
-   中间卷:冲突升级 + 揭示真相 + 盟友/敌人转换
-   最终卷:决战 + 主角完成转变 + 所有伏笔兑现
-   你觉得这个分法合适吗?"
-
-如果用户确定了卷数 → 逐卷追问:
-  "第一卷的核心任务是什么?用一句话说——主角在这一卷结束时,发生了什么不可逆的变化?"
-  推荐:每卷必须有一个"不可逆的变化",否则这卷可以合并。
-
-遍历完所有卷的核心任务 → 追问全书高潮:
-  "全书的最高潮在哪一卷?这个高潮为什么是不可替代的?"
-  推荐:全书最高潮应该是主角神圣缺陷被最终考验的时刻。
-```
-
-**第二层:卷纲细化**
-
-对每一卷,逐个追问:
-
-```
-起点问题:"第 {N} 卷的高潮是什么事件?"
-
-如果事件模糊 → 追问:
-  "这个高潮事件中,主角面临的具体选择是什么?"
-  推荐:最好的高潮是一个两难选择——两个选项都有代价,主角的选择揭示了 ta 的本质。
-
-追问铺垫:"这个高潮需要哪些铺垫?"
-  → 推荐:列出至少 3 个必须在之前章节种下的伏笔/线索
-
-追问爽点:"这一卷有几个高潮点?分别在哪些章节附近?"
-  → 推荐:每卷 2-3 个高潮点,第一个在卷的 1/3 处,最后一个在卷末
-
-追问情感弧线:"主角在这一卷的情感弧线是什么?从什么状态到什么状态?"
-  → 推荐:情感弧线必须与神圣缺陷的进展挂钩——这卷让主角离克服缺陷更近一步,还是把 ta 推得更远?
-
-追问卷末钩子:"这一卷结尾留下什么钩子让读者必须看下一卷?"
-  → 推荐:卷末钩子必须是全书级别的——不是"下一章会怎样",而是"整个故事的走向要变了"
-```
-
-**第三层:细纲关键节点**
-
-在大纲基本确定后、写具体章纲前:
-
-```
-起点问题:"我们先聊前 10 章的细纲。第 1 章的钩子是什么?"
-
-追问链(对关键章——第 1、3、10、每卷首尾章):
-  1. "这一章的核心事件是什么?(一句话)"
-  2. "章末钩子是什么类型?期待感等级?" → 推荐:前 3 章章末钩子必须全是"强"
-  3. "这一章的爽点是什么?从哪一章开始铺垫的?" → 推荐:铺垫 < 3 章的爽点威力有限
-  4. "这一章推进了哪个伏笔?或者种下了什么新伏笔?"
-  5. "这一章结束后,读者的'然后呢?'会指向什么?"
-
-关键章之外的普通章:
-  "第 {N} 章到第 {M} 章的核心推进是什么?章末钩子级别?"
-  → 推荐:过渡章章末钩子至少是"中",不能连续 3 章"弱"
-
-如果发现节奏问题 → 追问:
-  "连续 {N} 章的钩子都是'中'或'弱',第 {X} 章能不能安排一个转折让钩子变强?"
-  推荐:给出具体的转折方案——新角色登场、隐藏信息揭示、盟友背叛、敌人援军到来
-```
+| 层 | 主题 | 起点问题 | 追问要点 |
+|---|------|---------|---------|
+| 1 | 全书结构 | 分几卷?每卷核心任务? | 不确定时→按字数推荐卷数(卷一:世界观+入局+小高潮,中间卷:冲突升级+真相揭示,最终卷:决战+转变+伏笔兑现) → 每卷必须有"不可逆变化" → 全书最高潮在哪卷(神圣缺陷被最终考验的时刻) |
+| 2 | 卷纲细化 | 第N卷的高潮是什么事件? | 高潮中主角的两难选择 → 需要哪些铺垫(至少3个伏笔) → 爽点分布(2-3个/卷,1/3处首高潮,卷末最高潮) → 情感弧线(与神圣缺陷进展挂钩) → 卷末钩子(全书级别:"故事走向要变了") |
+| 3 | 细纲关键节点 | 前10章细纲,第1章钩子是什么? | 关键章(1/3/10/卷首尾):核心事件+章末钩子等级+爽点类型+伏笔操作。普通章:核心推进+钩子级别(过渡章≥"中",不连续3章"弱")。节奏问题时→安排转折:新角色/隐藏信息/盟友背叛/敌人援军 |
 
 ### 共创结束条件
 
-全部三层遍历完毕,且满足:
-- 每卷有明确的核心任务和不可逆变化
-- 全书最高潮已确定且通过了"不可替代性"检查
-- 前 10 章的章末钩子等级已确认(无连续 3 章弱)
-- 每卷的高潮点位置已标记
-- 主角的情感弧线与神圣缺陷进展已对应到每卷
-- 用户对整体节奏(高潮—过渡—高潮)表示认可
+- 每卷有明确核心任务和不可逆变化
+- 全书最高潮已确定且不可替代
+- 前 10 章章末钩子等级已确认(无连续 3 章弱)
+- 每卷高潮点位置已标记
+- 主角情感弧线与神圣缺陷进展对应到每卷
 
 ### 共创输出
 
-大纲共创结束后,生成以下文件:
-
-1. `大纲/全書大纲.md` — 卷级鸟瞰,包含每卷核心任务、不可逆变化、高潮位置
-2. `大纲/卷纲_第N卷.md` — 每卷的高潮事件、铺垫清单、爽点分布、情感弧线
+1. `大纲/全書大纲.md` — 卷级鸟瞰,每卷核心任务、不可逆变化、高潮位置
+2. `大纲/卷纲_第N卷.md` — 每卷高潮事件、铺垫清单、爽点分布、情感弧线
 3. 前 10 章的 `大纲/细纲_第NNN章.md` — 核心事件、钩子、爽点、伏笔操作
 
-后续章节的细纲可以在写作过程中按需创建,但前 10 章细纲必须在开写前完成。
+后续细纲按需创建,前 10 章细纲必须在开写前完成。
 
 ---
 
@@ -992,50 +844,9 @@ Loop(最多 5 轮):
 
 ## 分析仪表板
 
-长篇写作需要数据驱动的质量管理。
-
-### 仪表板内容
-
-执行 `/仪表板` 或写完每一卷后自动输出:
+写完每一卷后输出数据快照,包含:章节数/总字数/达标率、质检通过率与趋势、钩子健康(活跃数/stale数/兑现率)、爽点间隔与钩子等级分布、情感跳变次数、修改轮次。
 
-```
-═══ {书名} 分析仪表板 ═══
-
-📊 基础数据
-  总章节数:{N}    总字数:{N}    平均字数/章:{N}
-  目标字数/章:{N}    达标率:{X}%
-
-📈 质检趋势
-  审计通过率:{X}%    近 10 章通过率:{X}%   趋势:↑/↓/→
-  S1 致命问题数:{N}    S2 严重问题数:{N}
-  最常见问题类型:{类型}
-
-🪝 钩子健康
-  活跃钩子:{N}    high 优先级:{N}
-  stale 钩子(>10章):{N}
-  平均兑现周期:{N} 章
-  钩子兑现率:{X}%
-
-💬 情感快照
-  当前主要角色情感状态摘要
-  最近情感跳变(>3 级):{N} 次
-
-🎯 爽点分布
-  最近 10 章爽点间隔:{最短}-{最长} 字
-  章末钩子强/中/弱分布:{N}/{N}/{N}
-  高潮章间隔:{N} 章
-
-🔄 修改频率
-  已批准章节被回退修改次数:{N}
-  平均每章修改轮次:{N}
-
-💰 Token 用量(最近 10 章)
-  平均 prompt tokens/章:{N}
-  平均 completion tokens/章:{N}
-  趋势:↑/↓/→
-```
-
-### 仪表板驱动的决策
+### 异常指标 → 行动
 
 | 指标异常 | 建议行动 |
 |----------|----------|
@@ -1068,52 +879,19 @@ Loop(最多 5 轮):
 
 ---
 
-## 快速命令
-
-| 命令 | 作用 |
-|------|------|
-| `/续写` | 加载追踪文件,写下一章 |
-| `/续写 N` | 写第 N 章 |
-| `/批量 N M` | 批量生成第 N 章到第 M 章 |
-| `/修改 N` | 修改第 N 章 |
-| `/审批` | 列出待审批章节,逐章审批 |
-| `/审批 N` | 审批第 N 章 |
-| `/钩子` | 查看活跃钩子 + 钩子健康报告 |
-| `/情感` | 查看情感矩阵当前状态 + 跳变警告 |
-| `/质检` | 对最近 3 章执行自修正循环 |
-| `/质检 全部` | 全书质检 |
-| `/大纲` | 查看/调整大纲 |
-| `/角色 {名}` | 查看/创建/修改角色 |
-| `/铁律` | 查看/修改项目铁律 |
-| `/上下文` | 生成续写快照 |
-| `/诊断 {想法}` | 对一个新的故事想法做题材诊断 |
-| `/问诊` | 启动深度问诊流程(开新书五层决策树,逐一提问) |
-| `/大纲共创` | 启动大纲共创流程(三层决策树,全书→卷→细纲关键节点) |
-| `/风格 {文件}` | 分析参考文本风格并导入 |
-| `/导入 {文件}` | 导入已有章节并逆向工程 |
-| `/改名 旧名 新名` | 全书统一重命名 |
-| `/仪表板` | 显示分析仪表板 |
-| `/进化` | 自动进化:收集→分析→变异→同步。输出到 evolution/ |
-| `/进化 报告` | 查看自优化状态(提示词、阈值、模式库) |
-| `/进化 完整` | 完整进化循环(每卷/每10章执行一次) |
-
----
-
 ## 语言规则
 
 跟随用户语言。中文写作遵循《中文文案排版指北》:中英文/数字间加空格,使用全角标点。
 
 ---
 
-## 自优化系统(OpenEvolve 启发的进化引擎)
+## 自优化系统
 
-本技能内置进化优化引擎,每次写作任务后自动执行。进化结果写入 `evolution/` 文件夹——**不修改本 SKILL.md**。
+进化数据位于 `evolution/` 目录,题材级共享(同题材所有项目共用)。**不修改本文件。**
 
-### 自动进化规则(铁律六)
+### 写前
 
-**写作前:** 自动执行进化脚本(不加参数即可)。脚本会自动 git pull 获取其他用户的最新进化数据并编译。这一步确保启动写作时进化数据是最新的。Linux/macOS 用 `evolve.sh`,Windows 用 `evolve.ps1`。
-
-**每次完成续写、修改、质检、批量生成后,自动执行:**
+执行进化脚本(不加参数,自动 git pull + compile):
 
 ```bash
 # Linux/macOS
@@ -1123,137 +901,26 @@ Loop(最多 5 轮):
 ~\\.claude\\skills\\novel-write\\scripts\\evolve.ps1
 ```
 
-进化脚本包含完整的 git 集成:
-- 写前:`git pull` → 获取其他用户事件 → `event_store.py compile` 重建 population.json
-- 写后:进化完成 → `git add evolution/genres/` → `git commit` → `git push`
-- 网络不通时降级为纯本地进化,不会报错中断
-
-**用户完全无需手动操作 git 或进化命令。** Claude Code 在执行写作任务前后各调用一次进化脚本(`evolve.sh` / `evolve.ps1`,按操作系统选择)即可。
+加载进化数据:
+1. 从 `项目铁律.md` frontmatter 的 `genre` 字段读取题材 → 映射到题材 ID(仙侠→xianxia, 玄幻→xuanhuan, 都市→urban, 恐怖→horror, 末世→system-apocalypse 等,无匹配回退 `other`)
+2. 优先读 `evolution/genres/{genre_id}/prompts/current_best.json` 中的最优提示词
+3. 优先读 `evolution/genres/{genre_id}/thresholds.json` 中的题材特定阈值
+4. 如题材目录不存在,回退到 `evolution/prompts/current_best.json`(技能级通用)
 
-- 连续写作 3 章以上无进化 → 警告
-- 每写完一卷(或每 10 章)→ 执行进化脚本的 `--full` 模式
-
-### evolution/ 目录
-
-题材级共享架构 — 同题材所有项目共享进化数据,跨书积累经验。
-
-```
-evolution/                          # 进化输出(由脚本维护,勿手动编辑)
-├── README.md                       # 目录说明
-├── thresholds.json                 # 技能级默认阈值(新题材继承此值)
-├── prompts/
-│   ├── current_best.json           # 技能级最优(无题材数据时回退用)
-│   └── population.json             # 技能级种群
-├── patterns/
-│   └── pattern_library.json        # 跨题材模式库
-├── evolution_log.md
-├── session_state.json
-└── genres/                         # 题材级共享进化(核心)
-    └── {genre_id}/                 # 如 other/, xianxia/, urban/
-        ├── thresholds.json         # 该题材调优后的质量阈值
-        ├── prompts/
-        │   ├── current_best.json   # 该题材最优提示词(写作时优先读取)
-        │   └── population.json    # 该题材完整种群
-        ├── patterns/
-        │   └── pattern_library.json
-        └── session_state.json      # 该题材跨项目会话状态
-```
-
-**题材识别:** 从 `项目铁律.md` frontmatter 的 `genre` 字段读取中文题材名,
-通过映射表转为 InkOS 题材 ID(仙侠→xianxia, 玄幻→xuanhuan, 都市→urban,
-恐怖→horror, 末世→other,等等)。无匹配时回退到 `other`。
-
-### 写作时如何使用进化数据
-
-**写前(Claude Code 自动执行):**
-1. 运行进化脚本(`evolve.sh` / `evolve.ps1`,不加参数)→ 自动 git pull + 编译最新进化数据
-2. 读取当前项目的 `项目铁律.md` → 提取 `genre` 字段 → 映射到题材 ID
-3. 优先读 `evolution/genres/{genre_id}/prompts/current_best.json` 中的最优提示词
-4. 优先读 `evolution/genres/{genre_id}/thresholds.json` 中的题材特定阈值
-5. 参考 `evolution/genres/{genre_id}/patterns/pattern_library.json` 中的写作模式
-6. 如题材目录不存在,回退到 `evolution/prompts/current_best.json`(技能级通用)
-
-**写后(Claude Code 自动执行):**
-7. 完成章节后执行进化脚本 `--project {项目路径}` 参数
-8. 系统自动:收集反馈 → 分析质量 → 提示词进化 → 同步阈值 → git add + commit + push
-9. 其他用户下次写作时自动 git pull 获取本次进化结果
-
-### 四大组件
-
-| 脚本 | 对应 OpenEvolve | 输出 |
-|------|-----------------|------|
-| `prompt_evolver.py` | Prompt Sampler + LLM Ensemble | `evolution/prompts/` |
-| `quality_tuner.py` | Evaluator Pool | `evolution/thresholds.json` |
-| `pattern_mine.py` | Program Database + MAP-Elites | `evolution/patterns/` |
-| `feedback_collector.py` | Artifacts Side-Channel | `evolution/session_state.json` |
-
-### 关键机制
-
-**题材级共享** — 同题材所有项目共享进化数据。写第二本末世时,第一本积累的提示词评分和阈值调优直接可用。
-
-**风格注入算子** — 从 `对标/{书名}/风格报告.md` 提取句式/对话/描写/节奏/语调特征,编码为提示词变体注入题材池。同题材多本书的风格报告可交叉融合。
-
-**岛屿模型** — 5 个独立提示词种群(writing / revision / quality_check / outline / hook_management),各自进化,每 2 代迁移精英。种群上限 35,底 30% 停滞 3 代后触发灭绝重播。
-
-**自适应阈值** — 根据近期通过率自动调整:通过率 > 90% → 提高通过线(防假通过);通过率 < 30% → 降低通过线(防过度打磨);五遍权重按各遍历史均分自动重分配。
-
-**早停机制** — 单岛连续 2 代提升 < 3% 跳过变异;连续 3 代提升 < 5% 触发灭绝重播(50% 题材种子 + 30% 风格注入 + 20% 幸存者交叉)。
-
-**双选择策略** — Top variants 用于优化(exploitation),Diverse variants 用于探索(exploration)。
-
-**多维评分** — 提示词变体按 P1-P5 各自追踪评分和试验次数,加权综合分驱动选择,而非单一 composite score。
-
-**事件溯源(Event Sourcing)** — 多用户 git 共享无冲突。每个用户写入不可变事件日志文件(`events/{timestamp}_{user}.json`),population.json 从事件编译生成。追加写入天然无 merge conflict。
-
-### 多用户 Git 共享
-
-```
-# 用户 A:写完章节,收集反馈,进化
-git pull origin main
-python3 ~/.claude/skills/novel-write/scripts/feedback_collector.py collect --project ... --chapter 33 --scores '{"P1":85,...}'
-# evolve.sh (Linux/macOS) 或 evolve.ps1 (Windows)
-bash ~/.claude/skills/novel-write/scripts/evolve.sh --project ... --full
-git add evolution/genres/other/events/
-git commit -m "evolve(other): ch33 feedback + mutation"
-git push origin main
-
-# 用户 B:获取用户 A 的进化成果
-git pull origin main
-bash ~/.claude/skills/novel-write/scripts/evolve.sh --project ... --compile   # 从事件重建 population.json
-# 继续写作,此时已包含用户 A 的优化
-```
-
-**冲突原理:** 每个用户写自己的 `events/{timestamp}_{user}.json` 文件——不同文件名,不同内容,git merge 零冲突。`population.json` 是编译产物,可 .gitignore 或 commit 为只读缓存。`git pull` 后运行 `--compile` 重建即可。
-
-### 手动命令
-
-> **操作系统:** `evolve.sh` 用于 Linux/macOS (bash),`evolve.ps1` 用于 Windows (PowerShell)。两个脚本功能完全相同,下面以 bash 为例:
+### 写后
 
 ```bash
-# 快速进化(写后自动调用的就是这个)
-#   Linux/macOS: ~/.claude/skills/novel-write/scripts/evolve.sh
-#   Windows:     ~\.claude\skills\novel-write\scripts\evolve.ps1
-~/.claude/skills/novel-write/scripts/evolve.sh
-
-# 指定项目完整进化(自动检测题材)
-~/.claude/skills/novel-write/scripts/evolve.sh --project /path/to/novel --full
-
-# 指定题材直接进化(跨项目共享)
-python3 ~/.claude/skills/novel-write/scripts/prompt_evolver.py evolve --genre xianxia --generations 5
+# Linux/macOS
+~/.claude/skills/novel-write/scripts/evolve.sh --project /path/to/novel
 
-# 查看进化状态
-~/.claude/skills/novel-write/scripts/evolve.sh --report
+# Windows (PowerShell)
+~\\.claude\\skills\\novel-write\\scripts\\evolve.ps1 -Project /path/to/novel
+```
 
-# 从事件日志重建进化数据(git pull 后执行)
-~/.claude/skills/novel-write/scripts/evolve.sh --project /path/to/novel --compile
-# 或直接指定题材
-python3 ~/.claude/skills/novel-write/scripts/event_store.py compile --genre other
+脚本自动完成:反馈收集 → 分析 → 进化 → git add + commit + push。网络不通时降级为纯本地模式。
 
-# 单独运行某组件
-python3 ~/.claude/skills/novel-write/scripts/prompt_evolver.py evolve --genre urban --generations 5
-python3 ~/.claude/skills/novel-write/scripts/quality_tuner.py tune --project /path/to/novel --auto
-python3 ~/.claude/skills/novel-write/scripts/pattern_mine.py show --category hook
+### 进化节奏
 
-# 查看某题材当前最优
-python3 ~/.claude/skills/novel-write/scripts/prompt_evolver.py show --genre xianxia
-```
+- 每次续写/修改/质检/批量生成后必须执行
+- 连续写作 3 章以上无进化 → 警告
+- 每写完一卷(或每 10 章)→ 加 `--full` 参数执行完整进化