AI エージェントに本プロジェクトを操作させる
「エージェントにプロジェクトを読ませる」から「1 つのスキルを全エージェントへ」まで 3 段階
本プロジェクトには AI コーディングアシスタント向けの AGENTS.md が同梱されています。この 1 冊を読めば、エージェントは導入・動画生成・失敗の原因究明までこなせます。エージェントに「まず覚えてもらう」手間を省きたいならスキルセットを導入し、複数のエージェントを使い分けるなら第 3 段階があります。
3 段階の導入方法
第 1 段階:エージェントを本リポジトリに向ける
リポジトリには AGENTS.md があり、環境要件・4 層のデプロイ検証チェックリスト・共通規約(ログ接頭辞、リトライモデル、i18n 規約)をまとめています。clone して、下の一文をエージェントに渡してください。
> このプロジェクトの AGENTS.md を読んで、依存関係をインストールし、API キーを設定してサーバーを起動して。
> デプロイ検証チェックを実行して。制限:AGENTS.md はリポジトリ内にあるため、エージェントが読める必要があります。またコード変更と操作の両方を扱っています。
第 2 段階:スキルセットを導入する
スキルセットは日常操作を 3 つのスキルにまとめ、エージェントがプロジェクトを一から把握する必要をなくします。中身はドキュメントと小さなスクリプトのみで、サービスコードは含まず、鍵も通りません。
3 つのスキル
- ✓使用:デプロイ、モード選択、タスク投入と進捗確認、手動モードのチェックポイントでの成果物編集
- ✓トラブルシューティング:失敗の本当の原因と、修正すべきかの判断
- ✓コントリビュート:コードを変更し、PR を CI に通す
推奨:flint でインストール
flint はローカル優先のオープンソース・スキルマネージャーです。スキルを一か所に集め、一度登録すれば任意のエージェント/プロジェクトのディレクトリへ配布できます。ローカルのソースのみを読み、自動で clone はしません(登録するのは上で clone したディレクトリです)。無料・オープンソースなので Star をいただけると嬉しいです。
git clone https://github.com/lcy362/agnes-video-generator-skills.git
npx flint-skills-hub # Sources → add the cloned directory (flint reads its skills/ subdirectory)または:手動でコピー(flint なし)
cp -R agnes-video-generator-skills/skills/* <project>/.agents/skills/同じスキルはただのディレクトリです。プロジェクトの .agents/skills/ へコピーすれば使えます(そのディレクトリを読むエージェントならどれでも)。代償は、プロジェクトごと・新しいエージェントごとに繰り返すことです。
導入後は「結果」を依頼する
- · タスクが失敗した。原因を突き止めて、修正すべきか教えて。
- · クリエイティブ動画が無音だった。ナレーションと字幕を設定して実行して。
- · 完了したタスクの絵コンテ指示を改善して、影響する部分だけ再生成して。
第 3 段階:1 つのスキルを全エージェントへ
複数のエージェントを使い分けるなら、スキルリポジトリを flint(ローカル優先のスキルマネージャー)に一度登録するだけ。symlink かコピーで、使っている全エージェントとプロジェクトのディレクトリに配布します。すべてローカル動作:クラウドもアカウントもテレメトリもありません。
Flint ↗エージェントが最も役立つ場面:手動モード
手動モードはチェックポイントでパイプラインを止めます。エージェントは成果物マニフェストを読み、ファイルを直接編集し、再実行される下流工程を提示してから承認します。「ナレーションを推敲して」が 1 回の依頼で済みます。
手動モードガイド →三者の境界
- AGENTS.md — 本プロジェクトのコード変更用
- スキルセット — 本プロジェクトの操作用
- 本ページ — サイトが参照する権威的な説明
はじめる
エージェントは必須ではありません。Web Studio はインストール不要、セルフホスト版が最も多機能です。
関連ページ
Agnes Video Generator セルフホスティングガイド | 無料AI動画ガイド
無料のオープンソースAI動画生成ツールを自分のパソコンやサーバーで実行:start.sh手動デプロイ、Dockerワンコマンド、npm CLI、AIエージェントの4つの方法を、完全なコマンド・システム要件・環境変数とともに解説。
手動モードの使い方 — 自動 vs 手動:雰囲気生成か精密な出力か | Agnes Video
Agnes Video Generator の手動モードの使い方:ストーリーボード、参照画像、動画クリップ、ナレーション、字幕、完成動画などのチェックポイントで一時停止し、各成果物を確認・修正してから続行。外部のより強い AI やツールと組み合わせて、明確な期待どおりの出力を実現。自動モードはアイデアから気軽に生成(vibe video generating)に、手動モードは明確な出力目標の微調整に向いています。
リリースノート — Agnes Video Generator
Agnes Video Generator の全バージョン更新履歴:新機能、改善、不具合修正、導入方法。v1.0 からの完全なバージョン履歴。
Documentation Behind the Agent Levels
The three agent levels described here (read AGENTS.md / install the companion skill set / distribute with flint) and their commands follow the official implementations of the companion skill repository and flint.
- agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)
AGENTS.md, the four-layer deployment checklist and the agent-operations document under docs/public follow this project's repository.
- agnes-video-generator-skills — 项目伴随技能库(使用 / 排障 / 贡献)lcy362 · GitHub (2026)
The three skills (usage / troubleshoot / contrib), their coverage and bundled scripts follow the companion skill repository.
- Flint — 本地优先的个人 AI 技能管理器(skills manager)与技能中枢lcy362 · GitHub (2026)
Registering external sources and symlink/copy distribution into agent and project directories, plus the local-first design, follow the flint repository.
信頼性について
この記事は第一線の実践者によって書かれており、主観的な印象による結論ではなく、arXiv論文、メーカー技術報告書、Stanford AI Indexなどの一手のソースをクロスチェックして書いています。
SandGrid@lcy362
Agnes Video Generator 開発者 · フルスタックエンジニア
オープンソースAIビデオ生成ツール「Agnes Video Generator」の著者、インディーズ开発者。プロジェクトはAgnes AIの完全に無料のビデオモデルに基づいており、MITプロトコルはオープンソースで、すでに1,000人以上のクリエイターがゼロコストでAIビデオを生産したことがある。長期にわたってビデオ生成モデルのエンジニアリングと普及に注目しており、記事の内容はすべて第一線の実践と一手の研究から来ています。
GitHub で見る最終更新:2026-08-21