RooYun

RooYun Skill & MCP

Claude Code、Codex、Cursor などの AI コーディングアシスタントから、一言で RooYun を操作できます。RooYun は、AIマンガ劇やAIショートドラマを制作するためのワークスペースです。

「この脚本を絵コンテプロジェクトにして」→ エージェントが RooYun でプロジェクトを作成し、キャラクター、シーン、小道具、絵コンテカードに分解します。料金を確認してから絵コンテ画像と動画を生成し、成果物は自動的にキャンバスに戻ります。

成果物はばらばらのファイルではなく、そのまま手作業で編集を続けられる無限キャンバスです。

English · エージェント連携ガイド · AIマンガ劇チュートリアル

---

連携方法を選ぶ

一番簡単なのは、公式サイトの エージェント連携 ページに従う方法です。そのページを AI コーディングアシスタントに渡せば、インストールもログインも自動で行います。以下では同じ連携方法を紹介します。最初の2つは公式サイトから直接インストールでき、GitHub は不要です。

方法	対象	使い方
リモート MCP	Claude Code、Cursor、Cline などの MCP クライアント	URL とトークンを入力
公式サイトから Skill をインストール	Claude Code、Codex、WorkBuddy など、シェルを利用できるすべてのエージェント	1つのコマンドでダウンロードして展開
Claude Code プラグイン（任意）	プラグインで管理し、プラグイン経由で更新したい Claude Code ユーザー	このリポジトリからインストール。内容は公式サイトからのダウンロードと同じ

1. リモート MCP

サービスアドレス：https://www.rooyun.com/api/mcp（Streamable HTTP）、認証ヘッダー Authorization: Bearer <令牌>。トークンは 個人センター → API アクセス で作成できます。

claude mcp add --transport http rooyun https://www.rooyun.com/api/mcp --header "Authorization: Bearer <你的令牌>"

Cursor、Codex、Cline、Cherry Studio などのクライアントの設定については、docs/mcp-clients.md をご覧ください。

2. 公式サイトから Skill をインストール

Skill には MCP にないローカルスクリプトが含まれており、ローカル素材のアップロード、成果物の一括ダウンロード、ローカルでの動画結合ができます。完全版と簡易版があり、どちらか一方をインストールしてください（どちらも「RooYun で生成して…」に応答するため、両方をインストールすると同時に起動しようとします）。

• 完全版 rooyun：「脚本 → キャラクター／シーン／小道具 → 絵コンテ → 声の決定 → 生成」という固定の手順でプロジェクトを構築し、15項目のワークフールールが付属します。
• 簡易版 rooyun-cli：機能一覧のみを提供します。プロンプトと手順は自分で決められ、プロンプトはそのまま送信されます。

# 完整版（精简版把地址换成 "https://www.rooyun.com/api/skill/bundle?variant=cli"）
curl -fL "https://www.rooyun.com/api/skill/bundle" -o rooyun-skill.zip
mkdir -p ~/.claude/skills
unzip -o rooyun-skill.zip -d ~/.claude/skills

インストール後に Claude Code を再起動し、「RooYun にログイン」と伝えてください。ログインコマンドが実行されてブラウザーが開くので、RooYun のページで「認証」を一度クリックすれば完了です。トークンはローカルの ~/.rooyun/credentials.json に保存されます。以降は node ~/.claude/skills/rooyun/scripts/dj.mjs update で更新できます。

Codex など AGENTS.md を読み込むツールの場合は、AGENTS.snippet.md をプロジェクトの AGENTS.md に貼り付けてください。インストール、権限、環境変数の詳細については、Skill に付属する README をご覧ください。コマンドラインツール scripts/dj.mjs は依存関係がなく、Node.js 18 以降が必要です。macOS、Linux、Windows で利用できます。

3. Claude Code プラグイン（任意）

公式サイトからダウンロードするものと同じ Skill です。違いはプラグインコマンドでインストールおよび更新する点だけです。

claude plugin marketplace add DeepHiveAI/rooyun-skill
claude plugin install rooyun@rooyun        # 精简版：rooyun-cli@rooyun

更新：claude plugin marketplace update rooyun を実行し、続いて claude plugin update rooyun@rooyun を実行してください。

中国国内から GitHub へのアクセスが遅い場合は、最初のコマンドを Gitee ミラーに置き換えてください。それ以外は同じです。

claude plugin marketplace add https://gitee.com/yichuanWorks/rooyun-skill.git

このリポジトリには rooyun-mcp プラグインもあります。上記のリモート MCP に接続するだけのプラグインで、インストール時に表示される案内に従ってトークンを入力します（システムの安全なストレージに保存されます）。

プラグインをインストールせず、plugins/rooyun/skills/rooyun/ ディレクトリ全体を ~/.claude/skills/ にコピーすることもできます。公式サイトからインストールした場合と同じように使えます。

---

できること

• プロジェクトの構築：プロジェクトとキャンバスを作成し、キャラクター設定ボード、シーンカード、小道具ボード、絵コンテ動画カードを作成して、カードの接続や編集、自動レイアウトを行います。
• 脚本を読み取り、構成を作成：脚本をキャラクター、シーン、小道具、各ショットの絵コンテに分解し、編集後にキャンバスに反映します。
• コンテンツの生成：テキストから画像、画像から画像、画像から動画、最初と最後のフレーム、参照画像から動画、デジタルアバターのナレーション、吹き替え、音楽、効果音、動画の高画質化、動画から白モデルへの変換を行い、成果物を指定したカードに自動的に戻します。
• キャラクターの一貫性：衣装とメイクの参考写真を作品全体で参照画像として使用し、オーディションで声を決めて、同じキャラクターが作品全体で同じ声を使えるようにします。
• 白モデルのキャラクター差し替え：既存の動画を白モデルに変換し、新しいキャラクターに動作、立ち位置、カメラワークを再現させます。
• 参考作品の分析：参考動画の絵コンテ構成と物語上の役割を分析し、同じ構成で内容が異なる新しいシーンに作り替えます。
• 企画の情報収集：毎日の企画ブリーフを読み、参考にするクリエイターを登録して成長率を確認し、コピーライティングのナレッジベースから人気の表現を検索します。この機能は読み取り専用で、クレジットを消費しません。
• 成果物の取得と利用状況の確認：一括ダウンロード、完全性の確認、残高と請求明細の確認を行います。

できないこと（たとえば、API を使って動画を直接つなぎ合わせること）は、SKILL.md の冒頭に明記されています。エージェントは事前に知らせてくれます。

料金とセキュリティ

• 生成操作では RooYun のクレジットを消費します。Skill は、生成のたびにエージェントが事前に料金を提示し、あなたの確認後にのみ送信するよう求めます。一括生成には冪等キーが使われるため、再試行しても二重に課金されません。
• トークンの読み書きは dj.mjs のみが行い、エージェントが平文のトークンに触れることはありません。個人センター でいつでも確認し、利用上限を設定したり、無効化したりできます。
• 料金は生成前に表示される金額が適用されます。課金方法は料金案内をご覧ください。

リポジトリ構成

.
├── .claude-plugin/marketplace.json   # Claude Code 插件市场清单
├── plugins/
│   ├── rooyun/                       # 完整版 skill 插件
│   ├── rooyun-cli/                   # 精简版 skill 插件
│   └── rooyun-mcp/                   # 远程 MCP 插件
├── server.json                       # MCP Registry 登记信息
├── docs/mcp-clients.md               # 各 MCP 客户端配置
└── examples/                         # 示例剧本与提示词

このリポジトリについて

• このリポジトリは RooYun のメインリポジトリから自動同期して生成されます。Skill の内容は https://www.rooyun.com/api/skill/bundle からダウンロードできるものと完全に同じです。
• 中国国内向けミラー：gitee.com/yichuanWorks/rooyun-skill。内容はこのリポジトリと同じです。
• Issue や PR を歓迎します。PR はメンテナーが手動でメインリポジトリに取り込み、次回の同期時にここに反映されます。そのため、マージ後すぐに「マージ済み」と表示されるわけではありません。
• リモート MCP サーバーと RooYun プラットフォーム自体は、このリポジトリには含まれていません。

ライセンスと商標

コードとドキュメントは MIT ライセンス のもとで公開されています。

「RooYun」の名称とロゴは RooYun の商標であり、MIT ライセンスの対象外です。このリポジトリのコードを変更して再配布することはできますが、変更版を RooYun の名義で公開したり、公式版だと誤認させたりしないでください。