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/

通常の使い方

  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のイシューでバグ報告/機能要望。
  • 新しいジャンルプロファイルやAIフィルター規則の例の追加。
  • エージェント定義(agents/*.md)やスキルのSOPの改善。
  • プロジェクトのPython/Markdown規約に従ったコード変更。

この要約はリポジトリのREADMEに基づくのみ。追加の機能は推測していない。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト