awesome-novel-skill

1. 基本信息

项目	内容
名称	awesome-novel-skill
项目自述名称	awesome-novel（README 标题所用简称，正式名称仍以仓库名为准）
作者/维护者	modoojunko（GitHub）
来源链接	https://github.com/modoojunko/awesome-novel-skill
许可证	GPL-3.0（个人使用完全免费；商业使用需联系作者授权，详见仓库 LICENSE-DECLARATION.md）
GitHub Stars	436（来自 GitHub API）
Forks	50（来自 GitHub API）
最新版本	v4.8.4（仓库 VERSION 文件）
安装方式	`git clone` 后运行仓库自带的 `install.sh` / `install.ps1` 一键安装

2. 功能介绍与亮点

awesome-novel-skill 是一个面向 AI Coding Agent 的小说创作工作流技能包，让 Agent 从世界观搭建、角色塑造，到章节规划、正文写作，陪伴用户完成一整部小说。

核心设计是一套 7-Agent 协作体系：顶层 novel-agent 只负责调度与验收，不直接写正文，按进度分发给专职子 Agent——updater（设定与归档）、volume-planner/chapter-planner（分卷分章规划）、prompt-crafter/writer（文案与正文写作）、reader（可选的读者视角审阅）。

亮点：

题材知识库：内置仙侠、玄幻、都市、历史、悬疑等十余种题材的写作模板与人物原型，首次使用时按题材自动配置文风与节奏；
“去 AI 味”机制：anti-ai.md、prompt-audit.md 等文件专门治理 AI 写作中常见的“分析腔”“排比句”“价值升华式收尾”等痕迹，并有多位使用者在 issue 中反馈针对性改进（见第 8 章）；
状态化写作循环：以章节文件的状态字段驱动流转（规划→写作→校验→归档），而非黑箱式的一次性生成；
纯本地运行：不依赖任何外部付费 API，tools/ 下的初始化与同步脚本均为 Python 标准库实现，无第三方依赖。

仓库有 528 次提交、34 个 issue 与 45 个 PR 的公开记录，可见持续维护与真实用户互动。

3. 适用场景

固定分类：内容创作与知识管理

适合以下人群：

想借助 AI 写网络小说/类型小说，但不满足于“一句话生成全篇”、希望有世界观与人物一致性保障的业余作者；
需要长期维护一部连载小说（多卷多章）、担心设定前后矛盾的创作者；
对“AI 味”文风敏感、希望产出更接近人类网文腔调的用户。

不适合追求纯商业化、批量生成、无需人工打磨的场景——本技能仍需要作者持续给出题材反馈与方向把关。

4. 跨 Agent 兼容性

Claude Code：原生支持，install.sh claude-code 直接安装到 ~/.claude/skills/；
OpenClaw：原生支持，install.sh openclaw 安装到 ~/.openclaw/skills/；
Hermes Agent：原生支持，install.sh hermes 安装到 ~/.hermes/skills/；
Codex：官方 install.sh 与 skill.json 声明的支持平台列表（Claude Code / Hermes / OpenClaw / DeepSeek TUI / OpenCode）均未包含 Codex，需手动适配（技能本体是标准 SKILL.md，理论上可手动放入 Codex 的技能目录，但缺少官方安装路径）。

（以上判断均基于仓库内 install.sh 与 skill.json 的实际声明，未另行搜索验证。）

5. 推荐理由

在同类“AI 写小说”技能中，awesome-novel-skill 的差异化不在于功能堆料，而在于把“写作循环”拆解成可观测的小步骤（规划→写作→校验→归档），并且持续响应真实用户对文风的挑剔反馈（见第 8 章），这在同类项目里并不常见。安装零门槛、完全免费、代码纯本地运行不外联，适合想认真经营一部长篇小说、而不只是追求“一键生成”数量的用户。

6. 评分

维度	分数	说明
受欢迎程度	6	GitHub 436 Stars、50 Forks；34 个 issue 与 45 个 PR 显示有持续的真实用户互动（含具体使用反馈与一次社区二次开发），但尚未见规模化的跨平台讨论
可用性	9	一条命令 `git clone` + `install.sh` 即可安装；中英双语 README、ARCHITECTURE.md、CONTRIBUTING.md 文档完整；最近一次提交为 2026-07-20，维护活跃；个人使用完全免费，无需任何 API Key
安全性	8	见下方安全检查清单

安全检查清单：

检查项	结果
① Shell 命令与权限范围	`install.sh` 会向 `.bashrc`/`.zshrc`/`.profile` 写入一行环境变量（技能安装路径），有明确用途说明，且对安装目标路径做了越权保护检查；运行期工具 `tools/init.py`、`tools/sync-project.py` 仅做本地文件复制与 `git describe` 版本号读取，均为 Python 标准库实现
② 运行时联网	未发现任何外部网络请求，`requirements.txt` 注明“无需额外依赖”
③ API Key/凭据	不需要
④ 可疑指令	未发现 prompt injection 或混淆代码迹象
⑤ 作者/组织信誉	单一作者持续维护一年多个版本（v4.8.4），社区互动记录真实、无刷星/造假证据
⑥ License	GPL-3.0，条款清晰，个人/商业使用边界在 LICENSE-DECLARATION.md 中单独声明
⑦ 最近维护	近期仍有提交，维护活跃

7. 跟同类 Skills 相比的优势

项目	定位	与 awesome-novel-skill 的差异
oh-story-claudecode（worldwonderer）	覆盖长短篇网文全流程的一体化技能包：扫榜选题、拆解爆款、写作、去 AI 味、封面图生成	功能面更广（含选题扫描与封面生成），但是多 SKILL.md 的合集形态；awesome-novel-skill 是单一技能包，聚焦在“陪你从零写完一整部小说”的连贯体验，安装与心智负担更轻
novel-creator-skill（leenbj）	基于文件级长期记忆的 Smart State 模式，主打百万字级长篇的持续创作	更强调超长篇的记忆保持机制；awesome-novel-skill 则更强调题材知识库与“去 AI 味”的文风打磨，两者取向不同

8. 用户评价

sanye999（GitHub issue）：反馈生成内容“文学化比较严重”，与网络小说读者习惯的文风有落差，即便要求学习特定网文风格也难以还原，是关于文风适配的真实批评。
coolair01 与 hvens（GitHub issue，各自独立提出）：均反馈生成正文中破折号（“——”）使用过多、有明显“AI 味”，其中 hvens 具体统计 3000 字里出现 60 多个破折号，并建议在写作与检查环节增加对该标点的专项管控。

以上反馈均为已合并/已跟进的公开 issue，可见维护者对文风类问题有持续响应。

9. 其他补充

仓库提供中文、英文两种 README；社区曾提出将本项目迁移接入 Cherry Studio 等第三方创作工具的讨论。

10. 安装使用方式

git clone https://github.com/modoojunko/awesome-novel-skill.git
cd awesome-novel-skill
./install.sh claude-code   # 其他平台可替换为 hermes / openclaw / deepseek-tui / opencode

Windows 用户可使用 install.ps1。安装完成后无需重启，在想创作小说的项目目录下打开对应 Agent，直接说“帮我写本小说”即可触发引导流程；首次使用会询问题材、世界观与主角设定。

11. 注意事项

官方支持平台不含 Codex，Codex 用户需手动将技能文件放入对应技能目录，效果未经验证；
商业使用需联系作者获取授权，个人创作者不受影响；
生成文风可能偏“文学化”，追求快餐网文腔调的用户可能需要额外调教或结合题材模板反复迭代；
技能依赖 Agent 自身的写作能力，不内置任何文本生成 API，效果与所用底层模型能力直接相关。