Agent Skills

chinese-novelist-skill

让 AI 为你写一部完整的中文小说 - AI 驱动的中文小说创作助手 - 超过20章的小说，几分钟全稿完成 Claude Code Skill：自动创作分章节中文小说，每章悬念钩子

Installation
CLI
npx skills add https://github.com/zh30/chinese-novelist-skill --skill chinese-novelist-skill

Installez cette compétence avec la CLI et commencez à utiliser le flux de travail SKILL.md dans votre espace de travail.

Dernière mise à jour le 6/21/2026

chinese-novelist-skill

从"随便写个故事"到"写出能看的网文"，你需要的不只是灵感，而是一套防崩盘的工程化工作流。

✨ 这是什么

chinese-novelist-skill 是一套面向中文小说/网文创作的系统化工具。

它不是"AI 帮我写小说"的魔法咒语，而是：

  • 📋 防崩盘的结构：让长篇不乱、不水、前后一致
  • 🔍 AI 味检测器：自动识别"空洞情绪句""解释腔""四字堆砌"
  • 🎯 悬念导航系统：追踪每一条悬念的"新鲜度"，防止写到后面忘了前面
  • ⚡ 傻瓜化工作流：从"一句话创意"到"出版级小说"的可执行路径

🚀 快速开始（5 分钟上手）

第一步：创建小说

使用 chinese-novelist-skill，帮我写一本悬疑小说，20 章。

AI 会自动：

  1. 引导你填写「极简大纲」（10 个问题，5 分钟完成）
  2. 生成「进度仪表盘」（自动追踪进度）
  3. 开始写「第 1 章」

第二步：继续写作

继续写

AI 会自动：

  1. 读取「进度仪表盘」获取当前状态
  2. 检查悬念过期警告
  3. 提取人物当前状态
  4. 写「下一章」

第三步：质量检查

# 检查字数
python scripts/check_chapter_wordcount.py novels/我的小说/第01章.md

# 检查 AI味（自动检测"空洞情绪句""四字堆砌"等）
python scripts/check_ai_style.py novels/我的小说/第01章.md

📁 项目结构（优化后）

novels/
└── 我的小说/
    ├── 00-大纲.md                    # 极简大纲（10字段）
    ├── 99-进度仪表盘.md               # AI自动维护，一眼看进度
    ├── 01-人物档案-v2.md             # 人物核心引擎（驱动式）
    ├── 02-世界观与伏笔.md            # 世界观+悬念追踪表
    ├── 03-悬念追踪表.md              # 悬念生命周期管理
    ├── 第01章-血色黎明.md            # 章节文件
    ├── 第02章-暗流涌动.md
    └── ...

核心文件说明

文件 用途 谁维护
00-大纲.md 极简大纲：10 个核心问题 用户填写
99-进度仪表盘.md 当前位置、悬念状态、质量概况 AI 自动
01-人物档案-v2.md 欲望 - 恐惧引擎、声音指纹、缺陷 - 失败映射 用户填写
03-悬念追踪表.md 悬念 ID、状态、过期预警 AI 自动
第XX章-标题.md 章节正文 + 任务卡 + 复盘 用户+AI

🎯 核心功能

1. 三阶段工作流（简化）

不再纠结"策划模式还是连载模式"，只用记住三个阶段：

┌─────────────────────────────────────────────────┐
│  策划期 ────────────────────────────────────────→ │
│  目标：锁定大纲、人物、首章任务                     │
│  出口：首章任务卡完成                              │
├─────────────────────────────────────────────────┤
│  连载期 ────────────────────────────────────────→ │
│  目标：按章推进，自动维护悬念和人物状态              │
│  默认模式，你说"继续写"就行                         │
├─────────────────────────────────────────────────┤
│  收尾期 ────────────────────────────────────────→ │
│  目标：完稿检查、伏笔回收、结局收束                 │
│  触发：你说"写完了"                                │
└─────────────────────────────────────────────────┘

快速模式 vs 标准模式：

模式 触发词 特点 质量检查
快速模式 "快写""初稿" 跳过场景拆分，直接输出 仅字数 + 基础钩子
标准模式 默认 完整流程 红绿灯检查（3-5 项）

2. 红绿灯质量检查

每章只需检查 3-5 项核心指标，不再被 50+ 清单压垮：

🟥 红灯项（必须过关）

  • [ ] 变化原则：本章发生了不能删除的变化
  • [ ] 字数达标：≥3000 字（快速模式≥2500）
  • [ ] 钩子存在：结尾有明确的悬念/问题/张力
  • [ ] 人物一致：主要人物行为符合设定

🟨 黄灯项（建议优化，自动检测）

  • [ ] AI 味程度（运行脚本自动检测）
  • [ ] 对白自然度
  • [ ] 展示 vs 讲述比例

🟩 绿灯项（完稿时统一检查）

  • [ ] 伏笔回收状态
  • [ ] 整体节奏曲线
  • [ ] 人物弧线完整性

3. AI 味检测脚本

自动识别 9 种常见 AI 写作痕迹：

python scripts/check_ai_style.py novels/我的小说/第01章.md

检测维度：

维度 示例 严重程度
空泛形容词 "他很悲伤" "她非常开心" 🔴 重度
四字成语堆砌 "情不自禁、百感交集" 🟡 中度
解释性连接词 "然而、因此、不难看出" 🟡 中度
时间转折词滥用 "突然、就在这时、下一秒" 🟢 轻度
情绪标签句 "他感到前所未有的..." 🔴 重度
句式均匀 全是短句，没有变化 🟢 轻度
过度书面化对白 "我认为这个假设存在漏洞" 🟡 中度
视角混乱 一句话内切换多个角色内心 🔴 重度
信息倾倒 大段背景说明 🟡 中度

输出示例：

🤖 AI味检测报告

🔴 AI味评级：中度（综合得分: 4.2）

❌ 空泛形容词: 5/千字 (阈值: <3) 🔴 超标
   示例: "他很悲伤" "她非常开心"
   💡 建议: 用具体动作替代情绪标签

⚠️ 四字成语: 8/千字 (阈值: <5) 🟡 超标
   示例: "情不自禁" "百感交集"
   💡 建议: 参考 ai-style-examples.md 改写

📚 参考文档: references/ai-style-examples.md

4. 悬念生命周期管理

不再"提了悬念就忘"，自动追踪每条悬念的"新鲜度"：

悬念状态：

  • 🟢 活跃：最近提及，读者记得
  • 🟡 即将过期：5 章未提及，需保温
  • 🔴 已过期：10 章未提及，必须处理
  • ✅ 已回收：悬念已解答

自动预警：

⚠️ 悬念状态
- [001] 凶手是谁: 🟢 活跃（最近第8章提及）
- [002] 主角身世: 🔴 已过期（已10章未提及，必须在本章提及）
- [003] 宝藏位置: 🟡 即将过期（已5章未提及）

当前活跃悬念：3/6 ✅
本章建议：提及悬念002或003，防止过期

每章必须规划：

悬念 ID 操作 说明
001 推进 给出新线索
002 提及 简单提到，防止过期
003 - 本章不涉及

5. 三层叙事节奏体系

从"只能事后检查"到"事前可规划"：

宏观层（全本）：四幕结构 + 15 个关键节点

第一幕(25%): 建立冲突 → 第二幕(50%): 升级对抗 → 
第三幕(20%): 最终对决 → 第四幕(5%): 收尾

中观层（章节组）：黄金三章模式

每3章一个节奏单元: [铺垫] → [升级] → [小高潮+钩子]

微观层（单章）：3 次情绪起伏

20%位置: 进入冲突 → 50%位置: 矛盾激化 → 80%位置: 钩子落下

5 种题材特定模板：

  • 悬疑：疑问→调查→线索→反转
  • 玄幻升级：挑战→修炼→突破→震惊
  • 言情：误会→甜蜜→阻碍→和解
  • 种田：目标→阻碍→解决→收获
  • 都市现实：压力→应对→暂时解决→新压力

6. 人物档案 v2（驱动式引擎）

人物档案不再是"填空表格"，而是驱动写作决策的引擎：

核心引擎：

## 欲望 - 恐惧双引擎
- 自觉欲望（主角认为 Ta 想要的）：___
- 不自觉欲望（主角真正需要的）：___
- 核心恐惧（如果欲望不能实现）：___
- 道德前提（将被挑战的信念）：___

## 声音指纹
- 标志性对白（3-5 句锚点）：
  1. "..."
  2. "..."
  3. "..."
- 禁止用语（绝对不会说的话）：___
- 情绪状态下的声音变化：___

## 缺陷 - 失败映射
- 固有缺陷：___
- 可能造成的失败场景：
  1. 第 X 章：因___导致___
  2. 第 Y 章：因___导致___

写作时自动约束：

  • 每句对白生成后，对照「声音锚点」检查
  • 每个决策后，验证是否符合「核心价值观 + 恐惧」
  • 场景结束时，确保至少一条关系线变化

📚 完整文档索引

核心文档

模板文件

工具脚本

改进文档（第二轮）

改进文档（第三轮）

参考文档（原 v1）

🎓 使用教程

新手入门（推荐顺序）

  1. 5 分钟快速开始

    使用 chinese-novelist-skill，帮我写一本悬疑小说。

    → 跟随 AI 引导填写极简大纲

  2. 10 分钟理解工作流

    • 阅读 SKILL.md 的「三阶段工作流」部分
    • 了解「红绿灯质量检查」

  3. 20 分钟掌握质量

  4. 开始写作

    • 对 AI 说"继续写"
    • 每章完成后运行 check_ai_style.py

进阶使用

  1. 悬念管理

  2. 节奏设计

  3. 人物深化

💡 常见问题

Q: 优化后的 skill 和 v1 版本有什么区别？

v1 版本：

  • 6 种工作模式，容易迷路
  • 模板 100+ 字段，填写负担重
  • 质量检查 50+ 项，形式主义
  • 悬念静态记录，容易遗忘
  • AI 味只有负面清单，不知道怎么改

优化后：

  • 3 阶段工作流，傻瓜化
  • 极简模板 10 字段，5 分钟开始
  • 红绿灯检查，3-5 项核心
  • 悬念动态追踪，自动预警
  • AI 味改写范例，9 种症状都有前后对比

Q: 我可以只用部分功能吗？

可以。skill 采用「渐进式约束」：

  • 新手：只用极简大纲 +「继续写」+AI 味检测
  • 进阶：启用悬念管理 + 节奏设计
  • 专家：完整使用人物 v2+ 场景工具

Q: 适合哪些题材？

内置 5 种题材模板：

其他题材可以使用通用模板，效果也很好。

Q: 需要学习成本吗？

最小学习成本（5 分钟）：

  1. 对 AI 说"帮我写本小说"
  2. 跟随引导填写极简大纲
  3. 说"继续写"

推荐学习成本（1 小时）：

完整掌握（1 天）：

  • 通读 SKILL.md
  • 理解三层工作流
  • 掌握悬念管理和节奏设计

🔧 安装

方法一：完整克隆（推荐）

git clone https://github.com/henry/chinese-novelist-skill.git
cd chinese-novelist-skill

方法二：手动下载

  1. 下载本仓库 ZIP
  2. 解压到 skill 目录
  3. 让工具重新加载 skill

支持的 AI 工具

工具 安装路径 说明
Claude Code ~/.claude/skills/ 推荐
OpenCode ~/.config/opencode/skills/ 支持
其他 参考各工具文档 通用 Markdown skill

📊 版本记录

  • v1.0.0 → v2.0.0（三轮优化后）
    • 工作流简化：6 模式→3 阶段
    • 新增 AI 味检测脚本
    • 新增悬念生命周期管理
    • 新增三层节奏体系
    • 新增人物档案 v2（驱动式）
    • 新增场景设计 v2（可执行工具）
    • 新增按题材 AI 味清单
    • 新增钩子映射表

详见 OPTIMIZATION_PLAN.md

🙏 致谢

本 skill 的设计理念参考了：

  • 《故事》（罗伯特·麦基）- 故事结构
  • 《写作这回事》（斯蒂芬·金）- 写作实践
  • 《千面英雄》（约瑟夫·坎贝尔）- 英雄之旅
  • 网文平台爆款分析 - 节奏和钩子

📄 许可证

MIT License - 自由使用，欢迎改进

最后提醒：好作品是改出来的。第一遍写出来，第二遍用 check_ai_style.py 检测，第三遍对照 ai-style-examples.md 改写。三遍之后，AI 味去除 90%。

Happy Writing! ✍️