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/

典型用法

  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 還需要 pyyamlpip 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;未推斷任何額外功能。

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案