PixPipeline は「AIエージェントにノードグラフを組ませてドット絵素材を量産する」使い方を 公式にサポートしています。ファイル操作とコマンド実行ができるAIエージェント (Claude Code など)が別途必要です。
ai/ フォルダ
配布物の ai/ フォルダにAI向けの一式が入っています。
| ファイル | 内容 |
|---|---|
README_ja.txt / README_en.txt |
人間向けの導入手順 |
FOR_AI_START_HERE.md |
AIが最初に読む入口。役割と参照先の案内 |
node_catalog.json |
全ノードの正確な仕様(実装から自動生成) |
custom_node_catalog.json |
公式カスタムノードの仕様 |
PROJECT_FILE_SPEC.md |
.ppl ファイル形式の仕様 |
manual/ |
このマニュアル一式(使い方の質問に答える用) |
LESSONS.md |
AI生成セッションの知見集 |
samples/ |
動作するサンプルプロジェクト |
skill/pixelart-author/ |
Claude Code 用スキル |
使い方(素材を作らせる)
- AIエージェントを配布フォルダで起動する
- 「
ai/FOR_AI_START_HERE.mdを読んでから、◯◯のタイルを作って」のように頼む - AIが .ppl を生成し、headless実行で書き出し、結果を確認して反復する
使い方(操作を教えてもらう)
- 「
ai/manual/を参照して、スロープブラーの使い方を教えて」のように、 マニュアルの場所を添えて質問すると、手元のバージョンと一致した正確な回答が得られる
headless 実行(自動運転)
.\app\PixPipeline.exe --headless --project .\projects\foo\foo.ppl
.\app\PixPipeline.exe --headless --project .\projects\foo\foo.ppl --validate-only
.\app\PixPipeline.exe --headless --project .\projects\foo\foo.ppl --require-export
- プロジェクトを開いて1回評価し、Export系ノードの書き出しを実行して自動終了する
- 実行履歴は
user_data/settings/run_history.jsonとアプリ内の実行履歴ダイアログ (ヘッダーの時計アイコン)で確認できる
- ジョブファイル(パラメータ差し替え・タイムアウト指定)にも対応
- 既定でノード・パラメータ・接続・Variant Libraryを厳格検証する
--capture 12:output=debug.pngで、書き出しノードを増やさず任意の途中画像を保存できる--user-data <dir>で、自動実行専用のユーザーデータ場所を明示できる
知見の蓄積
- AIセッションで得た使い方の知見は
user_data/ai/側に蓄積され、アップデートでも残る - ツール自体の不具合・改善要望は
user_data/ai/AI_FEEDBACK_BACKLOG.mdへ分けて起票する