modoojunko/awesome-novel-agent
让 AI 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/ |
典型用法
- 安裝 – 在選定的AI控制台中說
幫我安裝 awesome-novel-agent。工具執行./install.sh <platform>。 - 建立小說專案 – 進入一個空資料夾,呼叫該技能(
/awesome-novel或@novel-agent)。代理將引導你完成題材、世界觀、角色與風格的選擇。 - 撰寫 – 使用
寫下一章、幫我繼續寫或solo(全自動)等命令。代理將生成大綱、提示詞、草稿,執行反AI過濾,可選審查,並將完成的章節歸檔。 - 迭代 – 任何時刻皆可修改設定(
改一下世界觀裡的…)或匯入自己的風格樣本。
安裝細節
- 需要 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 問題提交錯誤報告 / 功能請求。
- 新增題材設定或反AI規則範例。
- 改進代理定義(
agents/*.md)或技能 SOP。 - 遵循專案 Python/markdown 標準的程式碼變更。
本摘要僅基於倉儲的 README;未推斷任何額外功能。
相關
- 專案
- 專案
- 專案
- 專案
- 專案