modoojunko/awesome-novel-agent
让 AI agent成为你的小说创作搭档。从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。
awesome-novel-agent
何であるか – 大規模言語モデルエージェント(Claude Code、OpenCode、Reasonix、Codex、ZCode、DeepSeek Harness)を共同小説執筆アシスタントに変えるマルチプラットフォームスキル。9つの専門エージェント(アウトラインプランナー、プロンプト作成者、執筆者、AIフィルター、レビュアー、アップデータなど)と知識ベースを提供し、ジャンル選択から完成した原稿までユーザーを導く。
主な機能
- ワンコマンドセットアップ – AIツールに「install awesome-novel-agent」と発話すると、
install.shが実行され、選択されたプラットフォームに適切なユーザー層ディレクトリにスキルを配置する。 - プロジェクト初期化 –
init.pyがストーリーインデックス、設定、巻、章、プロンプト、アーカイブ、メモリ、知識、プラットフォーム固有のエージェント定義を含む完全な小説ワークスペースを作成する。 - エージェント駆動ワークフロー – 上位レベルの
novel-agentがサブエージェントを段階的に制御:セットアップ → アウトライン → 草稿 → AIフィルター → 必要に応じたレビュー → アーカイブ。ユーザーは各ステップで確認または編集するのみ。 - スタイル抽出 – サンプルテキストをインポート;
style-distillerが定量的なスタイルパラメータ(文の長さ、対話比率、形容詞密度)を抽出し、プロンプトに注入。モデルの声を継続的に最適化。 - AIフィルター – 専用の
anti-aiエージェントが複数段階のゲートを実行し、一般的な「機械的」表現を検出し削除。結果にスコアを付与。 - 動的メモリ – すべてのやり取り、好み、ルール更新はプロジェクトごとの
memory/ファイルに保存。頻繁に使用されるルールは永続メモリに昇格。 - ジャンルプリセット – 24の組み込みジャンルプロファイル(仙侠、都市、ミステリー、SFなど)が、デフォルトの世界観構築、キャラクターの原型、テンポテンプレートを提供。
- 2つの協働モード – ステップバイステップ(デフォルト、確認を求める)またはフル権限(
「あなたは完全な権限を持っています」)で手を離して生成。
対応プラットフォーム
| プラットフォーム | インストールパス(ユーザー層) | プロジェクト層フォルダ |
|---|---|---|
| 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に基づくのみ。追加の機能は推測していない。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト