novel-writer

网络小说创作与管理的系统化工具，支持版本控制、读者反馈管理和最佳实践积累。当用户提到写小说、创作小说、开始新小说、写第X章、创作下一章、继续写、重新创作第X章、重写第X章、修改第X章、初始化小说项目、创建小说仓库、让我们开始今天的创作、开始创作时间、进入写作模式时激活此 skill。

install

source · Clone the upstream repo

git clone https://github.com/alever520/openclaw-novel-writer-skill

Claude Code · Install into ~/.claude/skills/

git clone --depth=1 https://github.com/alever520/openclaw-novel-writer-skill ~/.claude/skills/alever520-openclaw-novel-writer-skill-novel-writer

OpenClaw · Install into ~/.openclaw/skills/

git clone --depth=1 https://github.com/alever520/openclaw-novel-writer-skill ~/.openclaw/skills/alever520-openclaw-novel-writer-skill-novel-writer

manifest: SKILL.md

source content

Novel Writer Skill

网络小说创作与管理的系统化工具，支持版本控制、读者反馈管理和最佳实践积累。

Skill 触发条件

当用户提到以下任一场景时激活本 Skill：

"写小说" / "创作小说" / "开始新小说"
"写第X章" / "创作下一章" / "继续写"
"重新创作第X章" / "重写第X章" / "修改第X章"
"初始化小说项目" / "创建小说仓库"
"让我们开始今天的创作吧" / "开始创作时间" / "进入写作模式"（新增）

功能模块

1. 项目初始化

触发: "初始化小说项目" / "创建新小说"

操作流程:

# 1. 创建项目目录结构
mkdir -p <novel-name>/{chapters,chapter-outlines,references,docs/{reader-feedback,characters,writing-guide}}

# 2. 初始化 Git 仓库
cd <novel-name>
git init
git remote add origin <github-url>

# 3. 创建基础文件
touch README.md
touch references/outline.md
touch references/reader-feedback.md
touch references/characters.md
touch references/writing-guide.md

# 4. 在 docs/ 子文件夹中创建说明文件
cat > docs/reader-feedback/README.md << 'EOF'
# 读者反馈收集文件夹

## 用途
存放读者反馈的原始记录文件。

## 文件格式
- Markdown 文件（.md）
- 建议按日期或主题命名（如：2026-03-23-反馈.md）

## 更新流程
1. 将读者反馈保存到此文件夹
2. 运行"更新读者反馈"指令
3. AI 会扫描新文件并更新 references/reader-feedback.md
EOF

cat > docs/characters/README.md << 'EOF'
# 人物设定卡收集文件夹

## 用途
存放人物设定的原始资料、草稿、参考图片等。

## 文件格式
- Markdown 文件（.md）
- 图片文件（.jpg, .png）
- 建议按人物名称命名（如：林墨.md、艾莉娅.md）

## 更新流程
1. 将人物设定保存到此文件夹
2. 运行"更新人物卡"指令
3. AI 会扫描新文件并更新 references/characters.md
EOF

cat > docs/writing-guide/README.md << 'EOF'
# 写作指导收集文件夹

## 用途
存放各类写作指导文档、最佳实践、技巧总结等。

## 文件格式
- Markdown 文件（.md）
- PDF 文件（.pdf）
- 建议按主题分类（如：节奏控制.md、人物塑造.md）

## 更新流程
1. 将写作指导文档保存到此文件夹
2. 运行"更新写作指导"指令
3. AI 会扫描新文件并更新 references/writing-guide.md
EOF

# 5. 填充模板内容

README.md 模板:

# <小说名称>

## 简介
[一句话概括小说核心]

## 目录
- [大纲](references/outline.md)
- [章节列表](chapters/)
- [创作指南](references/writing-guide.md)
- [读者反馈](references/reader-feedback.md)

## 状态
- 当前进度: X章
- 总规划: Y章
- 更新频率: [日更/周更]
- 最后更新: YYYY-MM-DD

## 版本历史
[自动记录最近 5 次提交]

outline.md 模板:

# <小说名称> 大纲

> 最后更新: YYYY-MM-DD

## 核心设定
- **主角**: 
- **世界观**: 
- **力量体系**: 
- **核心理念**: 
- **故事基调**: [热血/悬疑/温情/黑暗…]

## 卷次规划
### 第一卷: [名称] (第1章～第X章)
- **核心主题**: 
- **主要冲突**: 
- **角色成长**: 
- **结尾状态**: 

[... 更多卷次]

## 章节规划
### 第001章: [标题]
- **剧情目标**: [本章要完成什么]
- **场景**: [地点/时间]
- **关键事件**: 
- **人物动向**: 
- **节奏基调**: [平缓/紧张/转折…]
- **伏笔**: 新埋 [] / 回收 []
- **预计字数**: 约 XXXX 字
- **状态**: [ ] 待写 / [x] 已完成

[... 更多章节]

## 人物设定
### 主角
- **名字**: 
- **背景**: 
- **性格**: 
- **成长曲线**: 
- **核心恐惧/欲望**: 

### 核心配角
- **[配角名]**: [一句话描述，与主角的关系]

## 伏笔设计
### 短线伏笔（10章内回收）
- [ ] [伏笔内容] → 预计第X章回收

### 中线伏笔（卷内回收）
- [ ] [伏笔内容] → 预计第X章回收

### 长线伏笔（跨卷）
- [ ] [伏笔内容] → 预计第X卷回收

reader-feedback.md 模板:

# 读者反馈记录

## 格式说明
每条反馈记录格式:
- **日期**: YYYY-MM-DD
- **来源**: [评论区/私信/讨论组]
- **章节**: 第X章
- **类型**: [正面/负面/建议]
- **内容**: [原始反馈]
- **总结**: [提炼的关键点]
- **行动**: [是否需要调整，如何调整]
- **状态**: [待处理/已处理/已忽略]

---

## 反馈列表
[按时间倒序]

writing-guide.md 模板:

# 创作指南与最佳实践

## 来源说明
本文档总结自 docs/ 文件夹中的参考资料和实际创作经验。

## 总结方式 
本文档补充的内容需按照模版中的结构，在合适的地方插入

# 写作指南与最佳实践

## 一、本书定位

**一句话说清楚：**

核心卖点：

## 二、章节结构准则

### 开头铺垫

开头部分一般作为上一章故事的延续，节奏会相对换慢一些

每种方式记录：
**典型方式：**

**正确示例：**

**错误示例：**

**关键要素：**

### 发展推进

每种方式记录：
**典型方式：**

**正确示例：**

**错误示例：**

**关键要素：**

### 结尾钩子

留下悬念，让读者想看下一章。

每种方式记录：
**典型方式：**

**正确示例：**

**错误示例：**

**关键要素：**

### 检查清单
- [列举需检查的点]

## 三、章节节奏控制原则

### 基本要求

- 字数要求：[2000-4000]
- 每章至少完成一件事：[推进剧情、加深关系、公开新信息、制造冲突、兑现期待、埋伏笔]

### 情绪节奏

- 文章节奏: [节奏如何递进]
- 小高潮频繁:[主角赢一局、解锁新发现、人物关系推进]
- 大高潮蓄力：[大战、真相揭露、阶段突破]


### 信息密度

**原则**：高低密度交替，避免持续高密度（读者疲劳）或持续低密度（读者无聊）
- **高密度**：动作场面、大量对话、快速事件
- **低密度**：内心独白、环境描写、情感沉淀

### 章节长度与内容密度对照

| 章节字数 | 核心事件数量 | 场景数量 |
|---------|-------------|---------|
| 800-1500 | 1 个主要事件 | 1-2 个场景 |
| 1500-3000 | 1-2 个主要事件 | 2-3 个场景 |
| 3000-5000 | 2-3 个主要事件 | 3-5 个场景 |

**原则**：每章至少包含一个不可删除的核心事件。如果一个事件可以移除而不影响理解，则应删除。

### 检查清单
- [列举需检查的点]

## 四、章节内容创作原则

每种原则记录：
### 1. XXXX原则

#### 执行标准

**严格程度**: [100%严格执行]
- ✅ 默认要求: [所有情节都要"展示"]
- ⚠️ 例外情况:[如果后续遇到,再具体补充到本文档]
- 📝 原则:[遇到不确定的,先按严格标准执行]

#### 做法示例

每种做法列举：
**描述正确做法**:
- ❌ 错误示例：
- ✅ 正确示例：
**技巧说明：**

#### 常见错误示例表
列举常见的错误：
| 错误类型 | 示例 | 为什么致命 | 例外情况 |
|---------|------|-----------|---------|

### 检查清单
- [列举需检查的点]

## 五、人物塑造规范

**通用原则**: 

- 不需要逐个配角详细定义
- **符合人物性格设定即可**
- 有`characters.md`人物卡时参考

### 人物深度塑造技巧

每种技巧列举：
#### 1. XXX[技巧名称]

**技巧说明：**

每种示例列举：
**示例：**
- ❌ 错误示例：
- ✅ 正确示例：

### 人物出场设计

每种技巧列举：
#### 1. XXX[技巧名称]

**技巧说明：**

每种示例列举：
**示例：**
- ❌ 错误示例：
- ✅ 正确示例：

### 人物语言特征 

每个人物列举：
#### 人物XX[人物名称]

**性格定位**: 
- [列举性格定位]

**✅ 应该有的**:
- [列举符合人物定位的言行]

- **根据剧情的情绪变化**:
  - 危急时刻[紧张、愤怒]
  - 日常时刻[放松、幽默]

**❌ 不应该有的**:
- [列举不符合人物定位的言行]

**🎯 正确示例**:

**情绪变化示例**:

### 检查清单

角色行为必须符合已建立的性格。

**检查问题：**
- [列举需检查的点]

**例外处理：**
- [列举可不符合人物定位的特殊情况]

## 六、对话写作规范

好对话是揭示人物、推动情节、制造冲突的有力工具。

### 对话核心原则

#### ✅ 好对话的标准

#### ❌ 常见错误

#### 无意义对话的界定

**判断标准**: 对话删掉之后是不是完全没有影响

### 🎯 对话优化技巧详解

每个技巧列举：
#### **技巧x:[技巧名称]**

**核心**: [技巧要点]

每个示例列举：
❌ **正确示例**:
✅ **错误示例**:
**关键点**:

### 检查清单
- [列举需检查的点]

## 七、世界观呈现方式

### 核心原则

**✅ 需遵守的原则：**
- [列举需遵守的原则]  
**❌ 需避免的问题：**
- [列举需避免的问题]

每种方式列举：
### 方式x:[方式名称]

**原则：**

每种示例列举：
#### 示例x:[示例名称]

❌ **错误(直接解释)**:

✅ **正确(自然植入)**:

**示例说明：**
- [列举示例说明]

### 检查清单
- [列举需检查的点]

## 八、语言风格

### 核心原则

**✅ 需遵守的原则：**
- [列举需遵守的原则]  
**❌ 需避免的问题：**
- [列举需避免的问题]

每种问题列举：
### [问题名称]
**问题表现**：

**修改方法**：

**错误示例**:

**正确示例**:

### 检查清单
- [列举需检查的点]

## 九、视角与代入感

### 核心原则

**✅ 需遵守的原则：**
- [列举需遵守的原则]  
**❌ 需避免的问题：**
- [列举需避免的问题]

每种问题列举：
### [问题名称]
**问题表现**：

**修改方法**：

**错误示例**:

**正确示例**:

### 检查清单
- [列举需检查的点]

## 十、写作检查清单（每章完成前）
汇总上述除第一点外的所有检查清单

按照标题分别列举：
### XXX检查清单
- [列举需检查的点]

2. 章节创作流程

触发:

新创作："写第X章" / "创作下一章" / "继续写"
重新创作："重新创作第X章" / "重写第X章"

操作流程:

步骤1: 读取全局大纲与上章预告

# 1. 读取 references/outline.md
# 目的：掌握全局剧情走向，确认本章在整体故事中的位置和任务
# 重点关注：本章前后章节的衔接，本章需要完成的剧情节点

# 2. 读取上一章节的"下章预告"（如果存在）
# 位置：chapters/第XXX章-标题.md 文件末尾的"📖 下章预告"部分
# 目的：了解上一章埋下的伏笔、承诺的剧情走向，确保章节间连贯
# 处理：
#   - 如果是第001章，跳过此步骤（无上一章）
#   - 如果是第002章及以后，读取上一章的下章预告
#   - 将预告内容与 outline.md 整合，确保本章同时满足：
#     * 全局大纲的规划
#     * 上一章预告的承诺

整合原则：

上一章预告是"近期承诺"，优先级高于 outline.md 的"远期规划"
如果预告与大纲有冲突，优先按预告执行，并在步骤3创作章节大纲时注明差异
如果预告模糊或过于简略，以 outline.md 为准补充细节

outline.md 是整本小说的骨架，确保每章创作不偏离整体方向。
上章预告 是承上启下的桥梁，确保章节间无缝衔接。

步骤2: 读取人物卡

# 读取 references/characters.md
# 目的：了解本章涉及人物的设定，确保人物行为、对话、性格与人物卡一致
# 重点关注：
#   - 本章出场的已有人物：性格特质、行为模式、标志性特征、关系网络
#   - 本章新增人物：确认人物卡中是否已有设定，若无则在大纲确认后补充

人物卡是人物一致性的保障。每章创作前必须核对，避免人物写偏或前后矛盾。新增人物若暂无设定，创作完成后需及时更新
references/characters.md
。

步骤3: 创作章节大纲

基于步骤1读取的全局大纲和步骤2读取的人物卡，细化本章的执行方案。大纲必须包含以下七个模块：

📋 第XXX章《[标题]》章节大纲

**核心任务**
[具体到"谁在什么压力下做了什么"，不写泛泛的"推进剧情"，1-2句]

**世界观锚点**（嵌入正文，不旁白堆砌）
- [设定名称]：[一句话说明 + 对本章剧情的具体作用]
- [...]（如本章无新设定，写"无"]

**场景规划**

场景一：[场景名]（[地点，时间]）
[3-5句话说明：发生了什么 + 关键对话示例（至少1句）+ 场景结束时人物/情绪的变化]

场景二：[...]
[...]

**人物动向**
- [角色名]：[行动逻辑，说清楚起点和终点]
- [角色名]：[...]

**节奏安排**
- 开篇钩子：[第一句话或第一个动作，为什么能抓人]
- 小爽点：[位置+内容，一句话]
- 结尾留钩：[悬念或情绪余韵]

**伏笔处理**
- 新埋：[具体内容，每条一行 / 无]
- 回收：[具体内容 / 无]
- 延续：[上章遗留伏笔的本章推进 / 无]

**预计字数**：约XXXX字

场景内关键对话示例为必填项——它锁定人物在该时刻的状态和关系，防止创作时人物写偏。

生成大纲后，向用户确认：

以上是第X章的章节大纲，是否有修改建议？确认后进入下一步。

大纲确认循环：

若用户提出修改意见 → 按意见修改 → 再次展示 → 再次确认
大纲修改建议无需写入 reader-feedback.md，除非用户明确要求
用户确认后：
1. 将大纲写入
```
chapter-outlines/
```
  文件夹，命名格式与章节文件对齐：
2. 检查是否需要更新
  references/outline.md
  ：本章大纲可能涉及对后续章节的影响（剧情衔接、配角出场时机、主配角互动安排等），若有必要，更新 outline.md 的相关部分。若有改动，向用户展示：
```
📝 全局大纲更新
【改动位置】第X章 / 第X卷 / [具体位置]
【改动内容】[新内容]
【改动原因】[为何本章创作导致此处需要调整]
```
3. ⚠️ 上下文管理检查点：
  - 可清空：步骤1的全局大纲、上章预告
  - 可清空：步骤2的人物卡
  - 保留：当前章节大纲（已提炼的核心信息）
  - 原因：章节大纲已包含本章所需的关键信息，原始素材可释放
4. 进入步骤4

步骤4: 读取写作指导与读者反馈（⚠️ 必须完整读取）

⚠️ 本步骤必须执行,不可跳过。

4.1 读取写作规范

# 读取 references/writing-guide.md **完整文件**（不使用limit）
# 目的：理解所有章节结构、节奏控制、内容创作原则

⚠️ 关键要求：

必须完整读取：不使用
```
limit
```
参数，确保读取全部内容
理解所有规范：包括但不限于章节结构、节奏控制、对话写作、人物塑造、世界观呈现等所有部分
避免遗漏：部分读取会导致遗漏重要规范，影响创作质量

4.2 读取读者反馈

# 读取 references/reader-feedback.md **完整文件**
# 目的：了解所有待处理和已处理的反馈，避免重复犯错

筛选原则：

状态筛选：关注状态为"待处理"的条目
相关性判断：筛选与本章主题、场景、人物相关的反馈
记录待处理反馈数量：供用户确认

4.3 向用户汇报

⚠️ 必须输出以下格式的汇报,等待用户确认后再开始创作:

━━━━━━━━━━━━━━━━━━
📋 创作前检查汇报
━━━━━━━━━━━━━━━━━━

✅ 已完整读取写作规范 (references/writing-guide.md)
  - 文件行数：XXXX行
  - 包含章节：[列出主要章节名称]

✅ 已完整读取读者反馈 (references/reader-feedback.md)

【待处理反馈】(与本章相关，共X条)
  • [反馈摘要]: [需注意的点]
  • [反馈摘要]: [需注意的点]

或：✅ 无待处理反馈

━━━━━━━━━━━━━━━━━━

确认无误，等待用户批准开始创作。

步骤5: 创作章节正文

创作规则：

严格按步骤3确认的章节大纲推进剧情
场景顺序、节奏安排、伏笔处理均参照大纲执行
遵守步骤4读取的所有写作规范
遵守步骤4筛选的待处理反馈
字数目标参照大纲中【预计字数】
按需读取：
- 写到角色互动时 → 临时读取
```
references/characters.md
```
  对应角色卡
- 需要确认世界观设定时 → 临时读取相关参考文档

步骤6: 自检清单

⚠️ 执行前确认：

✅ 章节正文已完成
✅ 按大纲执行完毕

创作完成后，对照以下清单自检:

## 创作自检清单

### 大纲执行
- [ ] 场景序列与大纲一致（或有说明的合理偏差）
- [ ] 节奏安排符合大纲（高潮位置、收尾节奏）
- [ ] 伏笔处理符合大纲（新埋/回收/延续）
- [ ] 字数在大纲预计范围内

### 剧情
- [ ] 符合全局大纲规划
- [ ] 推进主线/支线
- [ ] 人物行为符合性格

### 语言（2026-03-27 强化）
- [ ] 避免短句堆砌
- [ ] 流畅自然
- [ ] 避免重复用词
- [ ] 对话符合人设
- [ ] **删除元叙事表述**（"狗血的""套路""网文"等跳出角色的词）
- [ ] **内心独白符合人物身份**（避免不符合人设的粗口、网络流行语）
- [ ] **感官描写有具体修饰词**（"灼烧的""嗡嗡的"等）
- [ ] **比喻精确且符合世界观**

### 节奏（2026-03-27 强化）
- [ ] 有张有弛
- [ ] 场景转换自然
- [ ] 爽点分布合理
- [ ] 信息密度适中
- [ ] **删除读者能自己理解的推理过程**
- [ ] **合并重复的对话和问题**
- [ ] **用疑问替代生硬的断言**

### 细节（2026-03-27 新增）
- [ ] **道具有世界观功能**（如恒温法阵）
- [ ] **人物描写包含脸型、眼睛颜色等具体细节**
- [ ] **数字形式统一**（对话中用阿拉伯数字）
- [ ] **生理反应符合情境逻辑**（刚醒来不能"好多了"）

### 读者反馈
- [ ] 已处理待解决问题
- [ ] 未重复已批评的错误
- [ ] 采纳合理建议

### 技术
- [ ] 文件命名规范: 第X章-标题.md
- [ ] Markdown 格式正确
- [ ] 字数符合要求

步骤6.5: 读者视角自审（⚠️ 强制执行，两轮迭代）

⚠️ 执行要求：

✅ 自检清单已完成
✅ 必须执行两轮自审
✅ 自动修改，不需要用户确认

流程说明：

第一轮自审 → 发现问题 → 修改
第二轮自审 → 发现新问题 → 修改
继续后续流程（步骤7）

第一轮自审

6.5.1 切换视角

内心独白切换为："我是一个网文读者，正在阅读这章。"

6.5.2 边读边标注

从头到尾重新阅读章节，标注以下问题：

😴 拖沓点：哪里让我想快进？
😕 困惑点：哪里我没看懂？
😠 不爽点：哪里让我感觉不舒服？
💔 情绪断层：哪里情绪没接上？
🤔 逻辑漏洞：哪里说不通？
🔧 细节遗漏：哪里细节不完整？（如：拿起笔没放下）
📖 重复描写：哪里写了两遍？

6.5.3 问题优先级分类

⭐⭐⭐ 高优先级：情绪断层、逻辑漏洞、严重不爽点
⭐⭐ 中优先级：拖沓点、重复描写、细节遗漏、困惑点
⭐ 低优先级：可有可无的优化、锦上添花的细节

6.5.4 生成修改方案

控制在5-10条问题，优先级排序：

## 📖 第一轮读者视角自审

### 发现的问题（优先级排序）

1. 【⭐⭐⭐ 情绪断层】段落X：托马斯质疑来得太突然
   - **修改建议**：增加触发点（记笔记行为）
   - **预计字数**：+50字

2. 【⭐⭐ 拖沓】段落Y：双重记忆重复描述
   - **修改建议**：删除第二次"记忆涌来"
   - **预计字数**：-30字

3. 【⭐⭐ 细节遗漏】段落Z：拿起笔没放下
   - **修改建议**：增加"放下笔"动作
   - **预计字数**：+5字

...（最多10条）

6.5.5 执行第一轮修改

按优先级从高到低依次修改
每次修改后检查上下文连贯性
记录修改字数（净增/净减）

6.5.6 记录到 reader-feedback.md

在

references/reader-feedback.md

中追加：

### [编号] 问题标题

- **来源**：AI自审（第一轮）
- **日期**：YYYY-MM-DD
- **关联章节**：第XXX章《标题》
- **状态**：✅ 已处理
- **优先级**：⭐⭐⭐ 高 / ⭐⭐ 中 / ⭐ 低

**反馈内容：**
[问题描述]

**处理方式：**
- [具体修改内容]
- **修改字数**：+XX字 / -XX字

**教训：**
[从这个问题学到的经验，供后续创作参考]

第二轮自审

6.5.7 重新阅读修改后的章节

再次以读者视角从头到尾阅读，关注：

第一轮修改是否引入新问题？
还有哪些遗漏的小问题？
整体流畅度如何？

6.5.8 发现新问题

控制在2-5条，标准同第一轮。

6.5.9 执行第二轮修改

同第一轮流程。

6.5.10 记录到 reader-feedback.md

标注为"AI自审（第二轮）"。

自审完成标准

✅ 完成两轮自审
✅ 所有高优先级问题已修复
✅ 所有中优先级问题已修复（或有合理理由保留）
✅ 修改记录已追加到
```
references/reader-feedback.md
```
✅ 章节质量评估：≥4.5/5星

步骤7: 读者视角自审（⚠️ 强制执行，两轮迭代）

⚠️ 执行要求：

✅ 自检清单已完成
✅ 必须执行两轮自审
✅ 自动修改，不需要用户确认

流程说明：

第一轮自审 → 发现问题 → 修改
第二轮自审 → 发现新问题 → 修改
继续后续流程（步骤8）

第一轮自审

8.1 切换视角

内心独白切换为："我是一个网文读者，正在阅读这章。"

8.2 边读边标注

从头到尾重新阅读章节，标注以下问题：

😴 拖沓点：哪里让我想快进？
😕 困惑点：哪里我没看懂？
😠 不爽点：哪里让我感觉不舒服？
💔 情绪断层：哪里情绪没接上？
🤔 逻辑漏洞：哪里说不通？
🔧 细节遗漏：哪里细节不完整？（如：拿起笔没放下）
📖 重复描写：哪里写了两遍？

8.3 问题优先级分类

⭐⭐⭐ 高优先级：情绪断层、逻辑漏洞、严重不爽点
⭐⭐ 中优先级：拖沓点、重复描写、细节遗漏、困惑点
⭐ 低优先级：可有可无的优化、锦上添花的细节

8.4 生成修改方案

控制在5-10条问题，优先级排序：

## 📖 第一轮读者视角自审

### 发现的问题（优先级排序）

1. 【⭐⭐⭐ 情绪断层】段落X：托马斯质疑来得太突然
   - **修改建议**：增加触发点（记笔记行为）
   - **预计字数**：+50字

2. 【⭐⭐ 拖沓】段落Y：双重记忆重复描述
   - **修改建议**：删除第二次"记忆涌来"
   - **预计字数**：-30字

3. 【⭐⭐ 细节遗漏】段落Z：拿起笔没放下
   - **修改建议**：增加"放下笔"动作
   - **预计字数**：+5字

...（最多10条）

8.5 执行第一轮修改

按优先级从高到低依次修改
每次修改后检查上下文连贯性
记录修改字数（净增/净减）

8.6 记录到 reader-feedback.md

在

references/reader-feedback.md

中追加：

### [编号] 问题标题

- **来源**：AI自审（第一轮）
- **日期**：YYYY-MM-DD
- **关联章节**：第XXX章《标题》
- **状态**：✅ 已处理
- **优先级**：⭐⭐⭐ 高 / ⭐⭐ 中 / ⭐ 低

**反馈内容：**
[问题描述]

**处理方式：**
- [具体修改内容]
- **修改字数**：+XX字 / -XX字

**教训：**
[从这个问题学到的经验，供后续创作参考]

第二轮自审

8.7 重新阅读修改后的章节

再次以读者视角从头到尾阅读，关注：

第一轮修改是否引入新问题？
还有哪些遗漏的小问题？
整体流畅度如何？

8.8 发现新问题

控制在2-5条，标准同第一轮。

8.9 执行第二轮修改

同第一轮流程。

8.10 记录到 reader-feedback.md

标注为"AI自审（第二轮）"。

自审完成标准

✅ 完成两轮自审
✅ 所有高优先级问题已修复
✅ 所有中优先级问题已修复（或有合理理由保留）
✅ 修改记录已追加到
```
references/reader-feedback.md
```
✅ 章节质量评估：≥4.5/5星

步骤8: 章节总结

⚠️ 执行前确认：

✅ 章节正文已完成
✅ 自检清单已执行

本步骤必须完成以下内容，一次性写入章节文件末尾：

创作完成后：

8.1～7.7 写入章节文件末尾，紧接正文，以如下分割线隔开：
```
（第 X 章完）

---
```
8.8 仅通过对话展示给用户，不写入文件。

8.1 章节小结

## 📝 章节小结

### 核心剧情
[用 2-3 句话概括本章主要情节]

### 人物表现
- **主角**: [本章行为/性格展现/成长点]
- **配角**: [重要配角的作用和表现]

### 关键对话
> [摘录 1-2 句重要对话]

### 场景亮点
[本章最出彩的场景或描写]

### 伏笔与呼应
- 新埋伏笔: [列出新设置的伏笔]
- 回收伏笔: [本章回收的之前伏笔]

8.2 写作自查

对照步骤6: 自检清单的结果，输出通过情况。

## ✅ 写作自查

### 大纲执行 (4项)
- [✅/❌] 场景序列与大纲一致
- [✅/❌] 节奏安排符合大纲
- [✅/❌] 伏笔处理符合大纲
- [✅/❌] 字数在大纲预计范围内

### 剧情 (3项)
- [✅/❌] 符合全局大纲规划
- [✅/❌] 推进主线/支线
- [✅/❌] 人物行为符合性格

### 语言 (8项)
- [✅/❌] 避免短句堆砌
- [✅/❌] 流畅自然
- [✅/❌] 避免重复用词
- [✅/❌] 对话符合人设
- [✅/❌] 删除元叙事表述
- [✅/❌] 内心独白符合人物身份
- [✅/❌] 感官描写有具体修饰词
- [✅/❌] 比喻精确且符合世界观

### 节奏 (7项)
- [✅/❌] 有张有弛
- [✅/❌] 场景转换自然
- [✅/❌] 爽点分布合理
- [✅/❌] 信息密度适中
- [✅/❌] 删除读者能自己理解的推理过程
- [✅/❌] 合并重复的对话和问题
- [✅/❌] 用疑问替代生硬的断言

### 细节 (4项)
- [✅/❌] 道具有世界观功能
- [✅/❌] 人物描写包含具体细节
- [✅/❌] 数字形式统一
- [✅/❌] 生理反应符合情境逻辑

### 读者反馈 (3项)
- [✅/❌] 已处理待解决问题
- [✅/❌] 未重复已批评的错误
- [✅/❌] 采纳合理建议

### 技术 (3项)
- [✅/❌] 文件命名规范
- [✅/❌] Markdown 格式正确
- [✅/❌] 字数符合要求

**自查通过率**: X/32 项 (XX%)

8.3 全局大纲更新记录（如有）

## 🗺️ 全局大纲更新

### 更新条目
- **改动位置**：[第X章 / 第X卷 / 具体位置]
- **改动内容**：[新内容简述]
- **改动原因**：[本章创作导致此处需要调整的原因，如：配角提前出场、伏笔衔接调整、节奏考量等]
- **影响范围**：[受影响的后续章节或人物线]

（无改动则写"本章无全局大纲更新"）

8.4 角色变更记录（如有）

## 🎭 角色变更

### [角色名]
- **变更类型**: [性格/能力/关系/外貌]
- **具体变更**: 
  - 旧: [原设定]
  - 新: [新设定]
- **变更原因**: [剧情需要/读者反馈/合理化调整]
- **影响**: [对后续剧情的影响]

**需要更新 characters.md**: ✅/❌

8.5 优化要点总结（仅重新创作时）

## 🔄 优化要点总结

### 相对旧版本的改进
1. **[改进类别]**: [具体改进内容]
   - 旧版问题: [存在的问题]
   - 新版优化: [如何改进]
   - 效果: [预期效果]

2. **[改进类别]**: [具体改进内容]
   ...

### 应用的最佳实践
- [x] [具体实践1]: [如何体现]
- [x] [具体实践2]: [如何体现]

### 字数对比
- 旧版字数: YYYY 字
- 新版字数: XXXX 字
- 变化: +/-ZZZ 字 (±X%)

8.6 下章概要

## 📖 下章预告

### 章节标题
第X+1章: [标题]

### 主要剧情
[用 2-3 句话概括下一章的核心内容]

### 关键场景
1. [场景1]: [简要描述]
2. [场景2]: [简要描述]

### 人物动向
- **主角**: [下章主要行动]
- **配角**: [重要配角的戏份]

### 伏笔推进
[本章埋下的伏笔将如何在下章展开]

8.7 字数统计

⚠️ 统计规则：只统计正文内容字数，不包括以下内容：

章节标题（
```
# 第XXX章 标题
```
）
Markdown 格式标记（
```
#
```
,
```
**
```
,
```
>
```
等）
章节后的元数据（核心目标、场景序列、伏笔等规划信息）
大纲中的说明性文字（"关键对话示例"、"人物动向"等）

统计方法：

# 推荐统计方式：去除标题行后的字符总数（含标点、空格）
python3 << 'EOF'
with open('chapters/第XXX章-标题.md', 'r', encoding='utf-8') as f:
    content = f.read()
lines = content.split('\n')
text_lines = [line for line in lines if not line.strip().startswith('#')]
char_count = sum(len(line) for line in text_lines)
print(f"正文字数: {char_count}字")
EOF

## 📊 字数统计

- **正文字数**: XXXX 字（去除标题行）
- **中文字符**: YYYY 字
- **段落数**: ZZ 段
- **对话占比**: XX%
- **描写占比**: YY%
- **内心独白**: ZZ%

**字数评估**:
- ✅ 符合目标字数 (3000-5000字)
- 或 ⚠️ 偏短/偏长，建议 [调整方向]

8.8 完整确认信息

在章节文件写入完成（含 7.1～7.7 追加到文件末尾）后，通过对话输出以下确认信息（包含 7.7 字数统计）。

新创作:

✅ 第X章《<标题>》创作完成！

━━━━━━━━━━━━━━━━━━━━━━
📋 章节大纲（已确认版）
━━━━━━━━━━━━━━━━━━━━━━

【核心目标】[...]
【场景序列】1. ... 2. ...
【伏笔】新埋: ... | 回收: ...

━━━━━━━━━━━━━━━━━━━━━━
📝 章节小结
━━━━━━━━━━━━━━━━━━━━━━

【核心剧情】
[2-3句话概括]

【人物表现】
• 主角: [表现和成长]
• 配角: [重要配角作用]

【关键对话】
> "[摘录重要对话]"

【伏笔与呼应】
• 新埋伏笔: [列举]
• 回收伏笔: [列举或"无"]

━━━━━━━━━━━━━━━━━━━━━━
✅ 写作自查
━━━━━━━━━━━━━━━━━━━━━━

大纲执行: ✅✅✅✅ (4/4)
剧情: ✅✅✅ (3/3)
语言: ✅✅✅✅✅✅✅⚠️ (7/8)
节奏: ✅✅✅✅✅✅✅ (7/7)
细节: ✅✅✅✅ (4/4)
反馈: ✅✅✅ (3/3)
技术: ✅✅✅ (3/3)

**通过率**: 31/32 项 (97%)

━━━━━━━━━━━━━━━━━━━━━━
📖 下章预告
━━━━━━━━━━━━━━━━━━━━━━

【标题】第X+1章: [标题]

【主要剧情】
[2-3句话概括]

【关键场景】
1. [场景1]
2. [场景2]

━━━━━━━━━━━━━━━━━━━━━━
📊 字数统计
━━━━━━━━━━━━━━━━━━━━━━

纯文本: XXXX 字
含标点: YYYY 字
段落数: ZZ 段

对话: XX% | 描写: YY% | 独白: ZZ%

**评估**: ✅ 符合目标字数范围

━━━━━━━━━━━━━━━━━━━━━━
💾 提交状态
━━━━━━━━━━━━━━━━━━━━━━

- 文件: chapters/第X章-<标题>.md
- GitHub: ✅ 已推送
- Commit: [commit-hash]

━━━━━━━━━━━━━━━━━━━━━━

是否继续创作下一章?

重新创作:

✅ 第X章《<标题>》重新创作完成！

[包含以上所有部分，额外增加]

━━━━━━━━━━━━━━━━━━━━━━
🔄 优化要点总结
━━━━━━━━━━━━━━━━━━━━━━

【改进类别】

1. **人物塑造**
   • 旧版问题: 主角形象扁平
   • 新版优化: 增加标志性动作、核心恐惧
   • 效果: 人物更立体可记忆

2. **语言流畅度**
   • 旧版问题: 短句堆砌
   • 新版优化: 长短句结合，自然过渡
   • 效果: 阅读更顺畅

【应用的最佳实践】
✓ 标志性特征强化
✓ 核心恐惧暗示
✓ 配角深度塑造

【字数对比】
旧版: YYYY 字
新版: XXXX 字
变化: +ZZZ 字 (+X%)

━━━━━━━━━━━━━━━━━━━━━━

【查看历史版本】
• git log --oneline -- chapters/第X章-<标题>.md
• git diff HEAD~1 -- chapters/第X章-<标题>.md

是否继续创作下一章?

步骤9: 提交到 GitHub

⚠️ 提交前验证：

用
```
tail -50 章节文件.md
```
确认末尾包含"## 📝 章节小结"
如果没有 → 立即回到步骤8补充

9.1 文件命名规范

# 统一命名格式: 第XXX章-标题.md（使用三位数编号）
chapters/第001章-新生.md
chapters/第023章-浮空城升空.md
chapters/第456章-终章.md

新创作和重新创作都使用相同的文件名，通过 Git 历史管理版本。

9.2 Git 提交规范

新创作:

cd <novel-name>
git add chapters/第X章-<标题>.md
git add README.md  # 更新进度
git commit -m "新增第X章: <标题> (XXXX字)"
git push origin main
git log --oneline -1  # 记录commit hash

重新创作:

cd <novel-name>
# 直接修改原文件（Git 会自动追踪变更）
git add chapters/第X章-<标题>.md
git add README.md  # 可选：更新说明
git commit -m "重新创作第X章: [改进要点]

- 应用最新最佳实践（标志性特征、核心恐惧等）
- 优化语言流畅度
- 增强人物立体感

字数: XXXX字（旧版YYYY字）"
git push origin main
git log --oneline -1

版本管理说明:

✅ Git 自动保存历史：每次提交都会保留完整的文件历史

✅ 查看历史版本：

git log --oneline -- chapters/第X章-标题.md

✅ 查看具体差异：

git diff <commit1> <commit2> -- chapters/第X章-标题.md

✅ 回滚到旧版本：

git checkout <commit-hash> -- chapters/第X章-标题.md

✅ 简洁的文件结构：每章只有一个当前文件，历史在 Git 中

3. 读者反馈处理

触发: 用户发送读者反馈内容

操作流程:

步骤1: 解析反馈

识别反馈类型:
- 正面: 称赞、喜欢的点
- 负面: 批评、不满
- 建议: 具体的改进建议
- 疑问: 对剧情/设定的疑问

步骤2: 记录到 reader-feedback.md

### 反馈 #X

- **日期**: YYYY-MM-DD
- **来源**: [评论区/私信]
- **章节**: 第X章
- **类型**: [正面/负面/建议]
- **内容**: 
  > [原始反馈内容]

- **总结**: 
  - 关键点1
  - 关键点2

- **行动**: 
  - [ ] 需要修改第X章
  - [ ] 后续章节注意XXX
  - [ ] 无需处理 (原因)

- **状态**: 待处理

步骤3: 分析影响

- 是否需要立即修改已发布章节?
- 是否影响后续大纲?
- 是否需要调整人物设定?

步骤4: 向用户汇报并询问

📝 读者反馈已记录！

【反馈总结】
- 类型: [正面/负面/建议]
- 关键点: [提炼的要点]

【影响评估】
- 影响章节: 第X章
- 影响大纲: [是/否]
- 严重程度: [高/中/低]

【建议行动】
1. [具体建议1]
2. [具体建议2]

是否立即处理? 
- 选项A: 立即修改相关章节（将按 **2. 章节创作流程** 完整执行，步骤1→7）
- 选项B: 仅记录，后续章节注意
- 选项C: 忽略此反馈

步骤5: 修改章节内容 (如用户选择 A)

无论是单章还是多章修改，均按 2. 章节创作流程 完整执行（步骤1→7），包括：

读取全局大纲（步骤1）
更新或确认章节大纲，视情况决定是否重新出章节大纲（步骤2）
读取写作指导与读者反馈（步骤3，本次反馈为必读重点）
创作/修改章节正文（步骤4）
自检清单（步骤5）
Git 提交（步骤6，commit message 注明"根据读者反馈修改"）
章节总结（步骤7）

多章修改时，逐章按以上流程依次完成，不跳步骤。

4. 更新读者反馈

触发: "更新读者反馈" / "同步读者反馈"

操作流程:

步骤0: 同步远程仓库（必须）

cd <novel-name>
git pull --rebase

⚠️ 重要: 所有检查操作前必须先同步远程仓库，确保本地和远程一致！

步骤1: 扫描 docs/reader-feedback/ 文件夹

cd <novel-name>/docs/reader-feedback
ls -lt *.md | head -10  # 列出最近修改的文件

步骤2: 读取新增/修改的反馈文档

# 对比上次更新时间，找出新文档
find docs/reader-feedback/ -name "*.md" ! -name "README.md" -newer references/reader-feedback.md

步骤3: 提取反馈要点

从新文档中提取:
- 反馈类型: 正面/负面/建议/疑问
- 关键点: 提炼核心观点
- 影响章节: 第X章
- 严重程度: 高/中/低
- 建议行动: 修改/记录/忽略

步骤4: 更新 references/reader-feedback.md

直接修改原文件，追加新反馈

## 反馈列表

### 反馈 #X - [标题]

- **日期**: YYYY-MM-DD
- **来源**: [评论区/私信/讨论组]
- **章节**: 第X章
- **类型**: [正面/负面/建议/疑问]
- **内容**: 
  > [原始反馈内容或摘要]

- **总结**: 
  - 关键点1
  - 关键点2

- **行动**: 
  - [ ] 需要修改第X章
  - [ ] 后续章节注意XXX
  - [ ] 无需处理 (原因)

- **状态**: 待处理

步骤5: Git 提交

git add references/reader-feedback.md
git commit -m "更新读者反馈: 新增X条反馈

来源:
- docs/reader-feedback/2026-03-23-反馈.md

反馈概要:
- [反馈1简述]
- [反馈2简述]

待处理:
- 第X章需要调整XXX
- 后续章节注意XXX"

git push

步骤6: 向用户汇报并询问

✅ 读者反馈已更新！

━━━━━━━━━━━━━━━━━━━━━━
📚 扫描结果
━━━━━━━━━━━━━━━━━━━━━━

【新增反馈文档】
• docs/reader-feedback/2026-03-23-反馈.md (新增)
• docs/reader-feedback/2026-03-24-反馈.md (新增)

【已整合反馈】
• docs/reader-feedback/2026-03-22-反馈.md (已处理)

━━━━━━━━━━━━━━━━━━━━━━
🎯 新增反馈摘要
━━━━━━━━━━━━━━━━━━━━━━

### 反馈 #1 - [标题]
- **类型**: [正面/负面/建议]
- **章节**: 第X章
- **关键点**: [提炼的要点]
- **严重程度**: [高/中/低]

### 反馈 #2 - [标题]
- **类型**: [正面/负面/建议]
- **章节**: 第Y章
- **关键点**: [提炼的要点]
- **严重程度**: [高/中/低]

━━━━━━━━━━━━━━━━━━━━━━
📊 影响评估
━━━━━━━━━━━━━━━━━━━━━━

• **需要立即修改**: 第X章（原因：[...]）
• **后续章节注意**: [...]
• **可以忽略**: [...]

━━━━━━━━━━━━━━━━━━━━━━
🔄 建议行动
━━━━━━━━━━━━━━━━━━━━━━

是否立即处理反馈？

- 选项A: 立即修改相关章节（将按 **2. 章节创作流程** 完整执行，步骤1→7）
- 选项B: 仅记录，后续章节注意
- 选项C: 忽略部分反馈

━━━━━━━━━━━━━━━━━━━━━━
💾 提交状态
━━━━━━━━━━━━━━━━━━━━━━

- 文件: references/reader-feedback.md
- GitHub: ✅ 已推送
- Commit: [commit-hash]

━━━━━━━━━━━━━━━━━━━━━━

5. 更新写作指导

触发: "更新写作指导" / "同步写作指导"

操作流程:

步骤0: 同步远程仓库（必须）

cd <novel-name>
git pull --rebase

步骤1: 扫描 docs/writing-guide/ 文件夹

cd <novel-name>/docs/writing-guide
ls -lt *.md | head -10  # 列出最近修改的文件

步骤2: 读取新增/修改的写作指导文档

# 对比上次更新时间，找出新文档
find docs/writing-guide/ -name "*.md" ! -name "README.md" -newer references/writing-guide.md

步骤3: 提取要点

从新文档中提取:
- 指导类型: 语言风格/节奏控制/人物塑造/信息展现/对话写法/其他
- 核心原则: 提炼可操作的规则
- 适用场景: 全局通用 / 特定场景（如首章/战斗/情感）
- 来源说明: 文档名称或章节

步骤4: 更新 references/writing-guide.md

将提取的要点整合进 writing-guide.md 对应章节，新内容追加或插入到最相关的位置：

### [对应章节名，如：节奏控制 / 语言风格 / 信息传递原则]

- **[规则标题]**：[具体内容]
  - ✅ [推荐做法]
  - ❌ [避免做法]
  - 来源：docs/writing-guide/[文档名].md（YYYY-MM-DD）

步骤5: Git 提交

git add references/writing-guide.md
git commit -m "更新写作指导: 整合 docs/writing-guide/ 新文档

来源:
- docs/writing-guide/[文档名].md

新增要点:
- [要点1简述]
- [要点2简述]"

git push

步骤6: 向用户汇报

✅ 写作指导已更新！

━━━━━━━━━━━━━━━━━━━━━━
📚 扫描结果
━━━━━━━━━━━━━━━━━━━━━━

【新增文档】
• docs/writing-guide/[文档名].md (新增)

【已整合】
• docs/writing-guide/[旧文档名].md (已处理)

━━━━━━━━━━━━━━━━━━━━━━
📝 新增要点摘要
━━━━━━━━━━━━━━━━━━━━━━

### [要点1标题]
- **类型**: [语言/节奏/人物/信息展现/对话]
- **核心规则**: [一句话概括]
- **适用场景**: [全局 / 特定场景]

### [要点2标题]
- **类型**: [...]
- **核心规则**: [...]
- **适用场景**: [...]

━━━━━━━━━━━━━━━━━━━━━━
💾 提交状态
━━━━━━━━━━━━━━━━━━━━━━

- 文件: references/writing-guide.md
- GitHub: ✅ 已推送
- Commit: [commit-hash]

━━━━━━━━━━━━━━━━━━━━━━

6. 更新人物卡

触发: "更新人物卡" / "同步人物设定"

操作流程:

步骤0: 同步远程仓库（必须）

cd <novel-name>
git pull --rebase

⚠️ 重要: 所有检查操作前必须先同步远程仓库，确保本地和远程一致！

步骤1: 扫描 docs/characters/ 文件夹

cd <novel-name>/docs/characters
ls -lt *.md | head -10  # 列出最近修改的文件

步骤2: 读取新增/修改的人物文档

# 对比上次更新时间，找出新文档
find docs/characters/ -name "*.md" -newer references/characters.md

步骤3: 提取人物设定

从新文档中提取:
- 基本信息: 姓名、年龄、种族、职业
- 外貌描写: 具象化特征
- 性格特质: 核心性格、优缺点
- 标志性特征: 动作习惯、口头禅、肢体语言
- 核心恐惧: 驱动行为的深层恐惧
- 成长曲线: 故事中的变化
- 关系网络: 与其他角色的关系
- 世界观背景: 出身、经历、动机
- 能力设定: 法术、技能、特长

步骤4: 更新 references/characters.md

直接修改原文件，新增或更新人物卡

## 🎭 主要角色

### X. [角色名]（新增/更新）

#### 基本信息
- **姓名**: [...]
- **年龄**: [...]
- **种族**: [...]
- **职业**: [...]
- **称号**: [...]

#### 外貌描写
- [具体特征]

#### 性格特质
- **核心性格**: [...]
- **优点**: [...]
- **缺点**: [...]

#### 标志性特征
- **动作习惯**: [每章X次]
- **口头禅**: [...]
- **肢体语言**: [...]

#### 核心恐惧
- **最深恐惧**: [...]
- **展现方式**: [...]
- **驱动行为**: [...]

#### 成长曲线
- **第一卷**: [...]
- **第二卷**: [...]
- [...]

#### 关系网络
- **[角色A]**: [关系]
- **[角色B]**: [关系]

#### 世界观背景
- **出身**: [...]
- **经历**: [...]
- **动机**: [...]

#### 能力设定
- **法术/技能**: [...]
- **战斗风格**: [...]

步骤5: 在文档末尾记录变更日志

## 📊 更新日志

### YYYY-MM-DD - [更新说明]
- **新增角色**: [角色名]
- **更新角色**: [角色名]
- **变更内容**: 
  - [具体变更1]
  - [具体变更2]
- **关联章节**: 第X章
- **变更原因**: [剧情需要/读者反馈/合理化调整]

**下次更新**: 根据剧情发展继续调整

步骤6: Git 提交

git add references/characters.md
git commit -m "更新人物卡: 新增/更新X个角色

来源:
- docs/characters/[角色名].md

新增角色:
- [角色A]: [简述]

更新角色:
- [角色B]: [变更内容]

关联章节: 第X章"

git push

步骤7: 向用户汇报并询问

✅ 人物卡已更新！

━━━━━━━━━━━━━━━━━━━━━━
📚 扫描结果
━━━━━━━━━━━━━━━━━━━━━━

【新增人物文档】
• docs/characters/多恩·铁砧.md (新增)
• docs/characters/塞拉斯·暗影.md (新增)

【已整合人物】
• docs/characters/林墨.md (已整合)
• docs/characters/艾莉娅.md (已整合)
• docs/characters/托马斯.md (已整合)

━━━━━━━━━━━━━━━━━━━━━━
🎭 新增/更新人物
━━━━━━━━━━━━━━━━━━━━━━

### 新增: 多恩·铁砧
- **基本信息**: 矮人工匠大师，45岁
- **标志性特征**: 脾气暴躁、技术狂热
- **口头禅**: "这不科学！哦不，这不魔法！"
- **作用**: 真理之塔总工程师

### 新增: 塞拉斯·暗影
- **基本信息**: 叛教牧师，38岁
- **核心秘密**: 携带死亡之神诅咒
- **作用**: 神学顾问，负责与神明交涉

━━━━━━━━━━━━━━━━━━━━━━
📊 影响评估
━━━━━━━━━━━━━━━━━━━━━━

• **创作参考**: 后续章节可引用新人物设定
• **标志性特征**: 创作时应用（动作习惯、口头禅）
• **关系网络**: 注意人物互动逻辑

━━━━━━━━━━━━━━━━━━━━━━
🔄 建议行动
━━━━━━━━━━━━━━━━━━━━━━

是否依据新人物设定进行创作？

- 选项A: 立即开始创作相关章节
- 选项B: 继续补充其他人物设定
- 选项C: 仅记录，后续使用

━━━━━━━━━━━━━━━━━━━━━━
💾 提交状态
━━━━━━━━━━━━━━━━━━━━━━

- 文件: references/characters.md
- GitHub: ✅ 已推送
- Commit: [commit-hash]
- 变更: +X个角色

━━━━━━━━━━━━━━━━━━━━━━

7. 版本管理与回滚

功能: 记录最近 5 次版本，支持回滚

实现方式:

记录版本 (自动)

# 每次 git commit 后自动更新 README.md 的版本历史区

## 版本历史
- [commit-hash-1] YYYY-MM-DD HH:MM - [commit message]
- [commit-hash-2] YYYY-MM-DD HH:MM - [commit message]
- [commit-hash-3] YYYY-MM-DD HH:MM - [commit message]
- [commit-hash-4] YYYY-MM-DD HH:MM - [commit message]
- [commit-hash-5] YYYY-MM-DD HH:MM - [commit message]

查看版本历史

git log --oneline -5

回滚版本 (用户请求)

触发: "回滚到第X次提交" / "撤销最近的修改" / "恢复到 [commit-hash]"

# 1. 列出最近 5 次提交
git log --oneline -5

# 2. 用户选择要回滚的版本
target_commit=[commit-hash]

# 3. 创建备份分支 (安全措施)
git branch backup-$(date +%Y%m%d-%H%M%S)

# 4. 回滚
git reset --hard $target_commit

# 5. 强制推送 (需要用户确认)
# ⚠️ 警告: 这会覆盖远程仓库
git push origin main --force

# 6. 更新 README.md 版本记录

用户确认流程:

⚠️ 版本回滚警告

【当前版本】
- Commit: [current-hash]
- 时间: YYYY-MM-DD HH:MM
- 内容: [commit message]

【目标版本】
- Commit: [target-hash]
- 时间: YYYY-MM-DD HH:MM
- 内容: [commit message]

【影响范围】
- 将丢失以下提交:
  1. [commit-1]: [message]
  2. [commit-2]: [message]
  
- 将丢失以下章节/修改:
  - [具体列出]

【安全措施】
- ✅ 已创建备份分支: backup-[timestamp]
- 如需恢复，可使用: git checkout backup-[timestamp]

是否确认回滚? (输入 YES 确认)

文件命名规范

章节文件

格式: 第XXX章-<标题>.md
示例: 第001章-新生.md
      第002章-废弃实验室.md

参考文档

outline.md               # 大纲（当前版本，Git 管理历史）
characters.md            # 人物设定卡（包含所有主要角色）
reader-feedback.md       # 读者反馈记录
writing-guide.md         # 创作指南与最佳实践

版本管理:

所有 references 文件直接修改，不创建副本
Git 自动追踪历史，可随时回滚
每次更新在文档末尾记录变更日志

文档参考

docs/
  ├── 网文写作指南.md
  ├── 爽文节奏分析.md
  ├── 人物塑造技巧.md
  └── ...

工作流示例

场景1: 启动新小说项目

用户: "我想写一个异世界魔法小说，帮我初始化项目"

Skill 执行:

询问项目基本信息 (名称、GitHub 仓库URL)
创建目录结构
初始化 Git 并关联远程仓库
创建基础文件 (README、outline、writing-guide、reader-feedback)
引导用户填写大纲

输出:

✅ 项目初始化完成！

【项目信息】
- 名称: <小说名称>
- 路径: <local-path>
- GitHub: <repo-url>

【下一步】
1. 请完善大纲 (references/outline.md)
2. 如有参考资料，放入 docs/ 文件夹
3. 准备好后，说 "开始写第一章"

场景2: 创作新章节

用户: "写第一章"

Skill 执行:

读取 outline.md，确认第一章的剧情规划
读取 writing-guide.md，加载创作原则
读取 reader-feedback.md，检查是否有待处理问题 (首章通常没有)
根据大纲创作第一章
自检清单检查
保存到 chapters/第001章-<标题>.md
更新 README.md 进度
Git 提交并推送

输出:

✅ 第一章《新生》创作完成！

【章节信息】
- 字数: 4700字
- 主要剧情: 主角穿越到异世界，发现魔法体系的问题，决定用科学方法改造
- 伏笔: 原主人实验失败的真相、保守派的敌意
- 下章预告: 获得废弃实验室，遇见神秘商人艾莉娅

【自检结果】
- 符合大纲: ✅
- 遵守最佳实践: ✅
- 处理读者反馈: N/A (首章)

【提交状态】
- GitHub 提交: ✅
- Commit: a1b2c3d 新增第001章: 新生 (4700字)

是否继续创作第二章?

场景3: 处理读者反馈

用户: "有读者说第三章的实验过程太详细了，看着有点枯燥"

Skill 执行:

记录反馈到 reader-feedback.md
分析影响:
- 问题: 实验描写过于详细
- 影响章节: 第三章
- 严重程度: 中
建议行动:
- 选项A: 简化第三章的实验描写
- 选项B: 后续章节减少技术细节，增加情节和冲突
向用户汇报并询问

输出:

📝 读者反馈已记录！

【反馈总结】
- 类型: 负面
- 关键点: 第三章实验过程描写过细，节奏慢，影响阅读体验

【影响评估】
- 影响章节: 第三章
- 影响大纲: 否
- 严重程度: 中

【建议行动】
1. 修改第三章: 压缩实验描写，保留关键步骤，增加人物思考和情感
2. 后续章节: 实验场景用"蒙太奇"手法，只展示关键突破

是否立即处理? 
- A: 立即修改第三章
- B: 仅记录，后续章节注意
- C: 忽略此反馈

场景5: 版本回滚

用户: "我觉得第三章改得不好，回滚到修改前的版本"

Skill 执行:

查看最近 5 次提交历史
识别"修改第三章"的那次提交
确认回滚目标
创建备份分支
请求用户确认

输出:

⚠️ 版本回滚警告

【当前版本】
- Commit: a9b8c7d
- 时间: 2026-03-23 15:30
- 内容: 根据读者反馈修改第三章: 简化实验描写

【目标版本】
- Commit: f6e5d4c
- 时间: 2026-03-23 10:00
- 内容: 新增第003章: 第一次实验 (4900字)

【影响范围】
- 将丢失以下提交:
  1. a9b8c7d: 根据读者反馈修改第三章
  
- 将丢失以下章节/修改:
  - 第三章的修改内容 (约500字删减)

【安全措施】
- ✅ 已创建备份分支: backup-20260323-1530
- 如需恢复，可使用: git checkout backup-20260323-1530

是否确认回滚? (输入 YES 确认)

Skill 元数据

skill_name: novel-writer
version: 2.4.0
author: OpenClaw
description: 网络小说创作与管理的系统化工具
triggers:
  - "写小说"
  - "创作小说"
  - "开始新小说"
  - "写第X章"
  - "继续写"
  - "重新创作第X章"
  - "重写第X章"
  - "读者反馈"
  - "更新读者反馈"
  - "更新人物卡"
  - "初始化小说项目"
  - "回滚版本"
dependencies:
  - git
  - github
capabilities:
  - 项目初始化（含三个 docs 子文件夹）
  - 章节创作（新创作+重新创作）
  - 读者反馈管理
  - 最佳实践更新
  - 人物设定卡更新
  - 写作指导更新
  - 版本控制与回滚
  - 章节总结与分析
changelog:
  v2.4.0:
    - 🆕 新增: 步骤7「读者视角自审」（强制执行，两轮迭代）
    - **核心变更**: 在步骤6（自检清单）和步骤8（章节总结）之间插入强制自审环节
      - 第一轮自审: 发现5-10个问题 → 修改
      - 第二轮自审: 发现2-5个遗漏问题 → 修改
      - 自动执行，不需要用户确认
    - **问题分类**: 😴拖沓点、😕困惑点、😠不爽点、💔情绪断层、🤔逻辑漏洞、🔧细节遗漏、📖重复描写
    - **优先级分类**: ⭐⭐⭐高（必修复）、⭐⭐中（建议修复）、⭐低（可选）
    - **记录机制**: 所有发现的问题自动追加到 `references/reader-feedback.md`
    - **质量目标**: 自审后章节质量≥4.5/5星
    - **步骤调整**: 原步骤7→步骤8，原步骤8→步骤9
    - **验证效果**: 第001章测试成功，发现并修复8个问题，质量从4星提升到4.5星
  v2.3.0:
    - 🔧 修复: 调整步骤顺序，防止遗漏步骤8（章节总结）
    - **核心变更**: 将原步骤7（提交GitHub）和步骤8（章节总结）互换
      - 新步骤7: 章节总结（写入文件末尾）
      - 新步骤8: 提交到 GitHub（最后一步）
    - 新增: 步骤6开头加检查点（确认正文和大纲已完成）
    - 新增: 步骤7开头加检查点（确认正文和自检已完成）
    - 新增: 步骤8开头加验证（tail 检查文件末尾是否包含章节小结）
    - **原因分析**: 原方案在Git提交后产生"任务完成"错觉，导致步骤8被跳过
    - **改进效果**: 文件编辑在Git提交前完成，逻辑更顺畅，不会遗漏总结
  v2.2.0:
    - 优化: 步骤4重构为智能提炼模式（降低token消耗70%+）
    - 新增: 4.1 读取并提炼写作规范
      - 从 writing-guide.md 每个大类中提炼1-3条与本章相关的规则
      - 总量控制不超过15条关键规则
      - 根据章节大纲智能判断相关性
    - 新增: 4.2 读取并筛选读者反馈
      - 只关注状态为"待处理"的条目
      - 筛选与本章主题、场景、人物相关的反馈
      - 无关反馈不列出
    - 新增: 4.3 汇报格式（按大类展示关键规则）
      - 清晰展示每个大类提炼的规则
      - 展示筛选后的待处理反馈
      - 用户能看到AI实际会遵守哪些规则
    - 新增: 4.4 上下文管理说明
      - 汇报后清空原文，保留提炼的关键规则
      - 正文创作时按提炼规则执行，无需重新读取
    - 效果: 原方案（完整保持5000字规范）→ 新方案（保留15条规则约500字）
    - 节省约90% token消耗（步骤4部分）
  v2.1.0:
    - 修正: 上下文管理策略（安全化，避免过早清空）
    - 核心变更：步骤1、2完成后不立即清空，改为在步骤3大纲确认后统一清空
    - 原因：LLM没有独立的"理解存储"，必须保持原文才能准确生成大纲
    - 新的检查点：步骤3大纲确认并写入chapter-outlines/后
      - 可清空：步骤1的全局大纲、上章预告
      - 可清空：步骤2的人物卡
      - 保留：当前章节大纲（已提炼的核心信息）
    - 步骤4（写作指导）：汇报后可清空，理解规则即可
    - 步骤5（正文创作）：只保持章节大纲，按需临时重读人物卡/世界观
    - 优势：更安全（生成大纲时信息完整）+ 仍省token（大纲确认后一次性释放）
  v2.0.0:
    - 新增: 章节创作流程步骤2 - 读取人物卡（references/characters.md）
    - 在步骤1（读取全局大纲）之后、步骤3（创作章节大纲）之前插入
    - 目的：确保本章涉及的已有人物和新增人物均参考人物卡设定，防止人物写偏
    - 重点核对：性格特质、行为模式、标志性特征、关系网络
    - 新增人物若暂无设定，创作完成后需及时更新 references/characters.md
    - 步骤编号顺移：原步骤2→3，原步骤3→4，原步骤4→5，原步骤5→6，原步骤6→7，原步骤7→8
  v1.9.0:
    - 新增: 第5节"更新写作指导"指令（原第5节顺移为第6节，版本管理顺移为第7节）
    - 触发词: "更新写作指导" / "同步写作指导"
    - 扫描 docs/writing-guide/ 文件夹，提取语言/节奏/人物/信息展现/对话等维度要点
    - 整合进 references/writing-guide.md 对应章节，追加来源说明
    - 更新 docs/writing-guide/README.md 说明文字，补充更新流程步骤
    - 修正: 步骤7(6.0)章节大纲回顾改为读取 chapter-outlines/ 对应文件，格式与步骤2七模块对齐
    - 规范: 第3节(读者反馈处理)步骤5 修改章节内容，明确按"2.章节创作流程"步骤1→7完整执行
    - 规范: 第4节(更新读者反馈)步骤6 用户选择A时，明确按"2.章节创作流程"步骤1→7完整执行
    - 多章修改时逐章依次完成，不跳步骤
    - 新增: 步骤2大纲确认后，检查是否需要更新 references/outline.md（剧情衔接、配角出场、主配角互动等影响后续章节的内容）
    - 新增: 若有全局大纲改动，向用户展示改动位置/内容/原因
    - 新增: 步骤7章节总结新增 6.3 全局大纲更新记录模块（写入章节文件）
    - 调整: 原 6.3～6.5 编号顺移为 6.4～6.7，完整确认信息更新为 6.8
    - 调整: 6.0～6.6 写入文件，6.7 字数统计写入文件，6.8 仅对话展示
    - 新增: 初始化流程中创建 chapter-outlines/ 文件夹
    - 新增: 步骤2（创作章节大纲）用户确认后，自动将大纲写入 chapter-outlines/第XXX章-标题-大纲.md
    - 优化: 步骤4（创作章节正文）开始前，可先读取 chapter-outlines/ 中的大纲文件（如需要）
    - 更新: README.md 目录结构说明增加 chapter-outlines/
    - 重构: 章节创作流程重新整理为清晰的7步骤（原步骤0+1+2+3 → 新步骤1+2+3+4）
    - 步骤1: 读取全局大纲（outline.md 是骨架，先读再动笔）
    - 步骤2: 创作章节大纲（七模块完整格式，场景内对话示例为必填项）
    - 步骤3: 读取写作指导与读者反馈，输出本章写作关键点总结
    - 步骤4: 创作章节正文（严格按确认大纲执行）
    - 步骤5-7: 自检清单 / 提交 GitHub / 章节总结（顺序不变，编号更新）
    - 新增: 章节大纲七模块格式规范（核心任务/世界观锚点/场景规划/人物动向/节奏安排/伏笔处理/预计字数）
    - 说明: 场景内关键对话示例为必填项，锁定人物状态防止创作偏差
    - 新增: 自检循环的汇报格式（三轮结果+修正记录）
    - 优化: 人物卡使用原则（主角不用标志性特征，配角限一个且与背景相符）
    - 新增: 场景转场规范（同章节内禁用分割线，仅多视角切换可用）
    - 新增: 宣言式独白检查（禁用"这才是X/这不是X而是Y"句式，改为行动或细节）
  v1.4.1:
    - 修复: 所有更新指令增加步骤0 - 同步远程仓库（git pull --rebase）
    - 重要: 确保本地分支和远程分支一致后再进行文件扫描
    - 适用: 更新读者反馈、更新人物卡、更新写作指导
    - 原因: 避免检查到过时的本地文件列表
  v1.4.0:
    - 新增: 初始化时创建三个 docs 子文件夹（reader-feedback/characters/writing-guide）
    - 新增: "更新读者反馈"指令，扫描 docs/reader-feedback/ 并整合到 references/reader-feedback.md
    - 新增: "更新人物卡"指令，扫描 docs/characters/ 并整合到 references/characters.md
    - 新增: "更新写作指导"指令，扫描 docs/writing-guide/ 并整合到 references/writing-guide.md
    - 优化: 三个更新指令统一格式（扫描→提取→更新→提交→汇报→询问）
    - 规范: 所有更新指令遵循 Git 版本控制原则
    - 文档: 在每个 docs 子文件夹中自动创建 README.md 说明文件
  v1.3.0:
    - 新增: references/characters.md 人物设定卡系统
    - 新增: 9个维度的人物卡格式（基本信息、外貌、性格、标志性特征、核心恐惧、成长曲线、关系网络、背景、能力）
    - 新增: 章节总结中增加"角色变更记录"部分
    - 优化: 创作时参考 characters.md 中的人物设定
    - 优化: 读者反馈可对照更新人物设定
    - 优化: 人物设定变更记录在文档末尾
    - 规范: characters.md 同样遵循 Git 版本控制原则
  v1.2.2:
    - 优化: references 文件更新统一遵循 Git 版本控制原则
    - 明确: 所有 references 文件直接修改，不创建副本或后缀版本
    - 新增: references 文件版本管理说明（查看历史、对比、恢复）
    - 优化: commit message 模板，包含详细更新内容和来源
    - 适用范围: writing-guide.md、outline.md、reader-feedback.md 等
  v1.2.1:
    - 优化: 更新最佳实践时明确列出参考的 docs 文件
    - 新增: 扫描 docs/ 文件夹并显示所有文档及修改时间
    - 新增: 区分"新文档"/"已整合"/"实战经验"三种来源
    - 优化: 汇报格式更清晰，使用分隔线和分类展示
  v1.2.0:
    - 新增: 章节小结（核心剧情、人物表现、关键对话等）
    - 新增: 写作自查清单（15项检查，自动评分）
    - 新增: 优化要点总结（重新创作时对比改进）
    - 新增: 下章概要（预告下一章剧情）
    - 新增: 字数统计（详细分析对话/描写/独白占比）
    - 优化: 确认信息格式（更清晰的分隔线和图标）
  v1.1.1:
    - 优化: 简化版本管理，完全依赖 Git 历史
    - 移除: 文件名版本号后缀（-v1, -v2）
  v1.1.0:
    - 新增: 重新创作章节功能
    - 新增: 规范化版本管理
  v1.0.0:
    - 初始版本

注意事项

GitHub 认证: 首次使用需配置 Git 用户信息和 GitHub Token
自动化程度: 创作过程中的自检是辅助性的，最终质量仍需作者把关
读者反馈: 并非所有反馈都需要处理，要有选择性
版本回滚: 强制推送会覆盖远程历史，务必谨慎操作
文件编码: 统一使用 UTF-8 编码，避免中文乱码

未来扩展

支持多分支创作 (主线/支线/番外)
自动生成章节目录和超链接
统计工具 (字数、更新频率、热词分析)
导出功能 (PDF、EPUB、TXT)
敏感词检查
与在线平台对接 (起点、晋江等)