modoojunko/awesome-novel-agent

awesome-novel-agent

是什么 – 一个将大语言模型代理（Claude Code、OpenCode、Reasonix、Codex、ZCode、DeepSeek Harness）转变为协作式小说写作助手的多平台 技能。它提供一组九个专业代理（大纲规划师、提示词创作者、写手、反AI过滤器、评审员、更新器等）和一个知识库，共同引导用户从选择题材到完成手稿的全过程。

核心功能

• 一键安装 – 向你的AI工具说“install awesome-novel-agent”，它将运行 install.sh，将技能安装到所选平台的适当用户级目录中。
• 项目初始化 – init.py 创建一个完整的小说工作区（包含故事索引、设置、卷、章节、提示词、归档、记忆、知识，以及平台特定的代理定义等文件夹）。
• 代理驱动工作流 – 顶层的 novel-agent 通过以下阶段协调子代理：设置 → 大纲 → 草稿 → 反AI → 可选评审 → 归档。用户只需在每个步骤确认或编辑即可。
• 风格提炼 – 导入样本文本；style-distiller 提取定量风格参数（句子长度、对话比例、形容词密度），并注入提示词中，持续优化模型的文风。
• 反AI过滤 – 专用的 anti-ai 代理运行多阶段过滤器，检测并移除常见的“机器味”表达，并对结果进行评分。
• 动态记忆 – 所有交互、偏好和规则更新都存储在项目级的 memory/ 文件中；频繁使用的规则会被提升为永久记忆。
• 题材预设 – 内置24种题材配置（仙侠、都市、悬疑、科幻等），提供默认的世界观构建、角色原型和节奏模板。
• 两种协作模式 – 逐步模式（默认，要求确认）或 全权授权（“you have full authority”）用于全自动生成。

支持平台

平台	安装路径（用户级）	项目级文件夹
Claude Code	~/.claude/skills/awesome-novel/	.claude/
OpenCode	~/.config/opencode/skills/awesome-novel/	.opencode/
Reasonix	（仅项目级）.<project>/.reasonix/skills/	.reasonix/
Codex	~/.codex/skills/awesome-novel/	.codex/
ZCode	~/.zcode/skills/awesome-novel/	.zcode/
DeepSeek Harness	~/.dsh/skills/awesome-novel/	.dsh/

典型用法

1. 安装 – 在选定的AI控制台中说 帮我安装 awesome-novel-agent。工具运行 ./install.sh <platform>。
2. 创建小说项目 – 进入一个空文件夹，调用该技能（/awesome-novel 或 @novel-agent）。代理将引导你完成题材、世界观、角色和风格的选择。
3. 写作 – 使用 写下一章、帮我继续写 或 solo（全自动）等命令。代理将生成大纲、提示词、草稿，运行反AI过滤，可选评审，并将完成的章节归档。
4. 迭代 – 任何时候都可以修改设置（改一下世界观里的…）或导入自己的风格样本。

安装细节

• 需要 Python 3.9+（macOS 自带 3.9；推荐 3.11+）。OpenCode/Codex/ZCode/DeepSeek 还需要 pyyaml（pip install pyyaml）。
• 运行 ./install.sh <platform>（Windows 上使用 install.ps1）。脚本在复制技能前会检查 Python 版本和依赖项。
• Reasonix 的技能通过 init.py 按项目部署，而非全局安装器。

项目结构（init 后）

<novel>/
├─ story.md                # 高层级索引
├─ settings/…              # 世界、风格、题材、时间线、角色
├─ volumes/                # 卷级大纲
├─ chapters/               # 章节级大纲
├─ prompts/                # 生成的提示词
├─ archives/               # 最终章节
├─ .agent/                 # 状态与任务文件
├─ .<platform>/            # 所选平台的代理、知识、记忆
└─ ...                     # 可选沙盒、样本等

仅创建与所选平台匹配的目录。

许可证 – GPL 3.0（个人使用免费；商业使用需作者许可）。

社区 – 提供 QQ 讨论群（ID 1006050538），用于支持、反馈和分享生成的小说。

贡献 – 参见 CONTRIBUTING.md。贡献方式包括：

• 通过 GitHub 问题提交 bug 报告 / 功能请求。
• 添加新的题材配置或反AI规则示例。
• 改进代理定义（agents/*.md）或技能 SOP。
• 遵循项目 Python/markdown 规范的代码变更。

---

本摘要仅基于仓库的 README；未推断任何额外功能。