
DEFで繰り返し入力の苦労を減らしたい ~comfyui-prompt-control~
⚠️2025/09/13 22時にImpactWildcardEncode・ImpactWildcardProcessor接続時の注意を追記
はじめに
今回はcomfyui-prompt-controlの機能の一つ「DEF」によるマクロ機能を解説する。
この機能だけを独立させたノードもあるので、comfyui-prompt-controlの他の機能を使わない場合も有用な知識だ。
マクロという名前だが、これはスクリプト的なものではない。単なる置換機能だ。
Cでもほぼ同じものがマクロと呼ばれていたので、そこから来ている名前だろう。
プロンプトを変更するだけだから、SDXLに限らず他のものに対しても使える。長い自然言語による指示を(一部だけ変更しながら)何度も記述する時にも役立ちそうだ。
今回も基礎編だ。記事内の行コメントについては前回の記事を参照してほしい。
使い方
📌すでにcomfyui-prompt-controlの「PC: Schedule Prompt」ノードを使っている場合、マクロはその中で自動的に処理される。よって、特別な準備は必要ない。
サンプル内のコメント部分を自動的に削除したい場合は先に置換ノードを通す必要があるが、手動で削除するなら気にしなくていい。
そうでない場合は、プロンプトの文字列がCONDITIONINGになる前に「PC: Expand Macros」ノードを挟めばいい。
たとえば「プロンプト入力用のString (multiline)」ノード→(コメント削除用の置換ノード)→「PC: Expand Macros」ノード→「ImpactWildcardEncode(などの、文字列を受け取ってCONDITIONINGを出力する)」ノード、といった流れだ。
このノードはマクロがうまく動かない時、どう処理されているかの確認にも役立つ。
2025/09/13 22時 追記
⚠️ImpactWildcardEncode・ImpactWildcardProcessorに外部からテキストを入力する際は、2番目のテキストボックス(Populated Prompt)につなぐこと。1番目ではプロンプトが処理されない。2番目ならワイルドカード機能などを含めて正常に処理される。
📌書式は「DEF(マクロ名=内容)」だ。
「内容」には改行を含めることもできる。
見やすさも上がるし、(行コメントによる)一部の有効・無効の切り替えも簡単になる。
基本的な使い方はこうだ。
// マクロ定義
DEF(GIRL=1girl, yellow eyes, orange hair, serafuku,)
// 改行も自由にできる
DEF(BOY=1boy,
blue eyes, blue hair,
school uniform,)
// マクロ使用部分
BOY
GIRL📌このように書くと、実行時に下の「GIRL」や「BOY」の部分が「1girl, yellow eyes, orange hair, serafuku,」や「1boy, blue eyes, blue hair, school uniform,」として処理される。

DEF内のタグが反映されていることが確認できる。
COUPLEを使っていないので目や髪の色が入れ替わる可能性はあるが。
サンプルではDEFをプロンプトの最初に書いているが、実際は末尾でもどこでもいい。
まずプロンプト全体からすべてのDEF()を検索&削除し、それからもう一度プロンプトを見直してマクロ使用部分を置き換える、という流れで処理される。
⚠️マクロの名前(GIRLやBOYの部分)にほぼ制限はない。danbooruタグやAND・COUPLEなどのキーワードも普通にマクロ名として使えてしまう。
混乱を避けるため、マクロ名はそれらのキーワードやタグとは違う名前にした方がいいだろう。
試した限り、マクロ名に使えないのはDEFそのもの(「DEF(DEF=内容)」)と正規表現の特殊記号の一部(「*」や「^」など)ぐらいだ。
単純な置換なので「DEF(日本語のマクロ名=内容)」でも動くのだが、「大文字の英数字」「_」「-」の組み合わせにしておくのが無難だろう。
大文字にするのは(タグを必ず小文字で書くことで)意図しないマクロの使用を避けるためだ。
さらに「ここでマクロを使っているぞ!」という目印にもなる。
マクロ in マクロ
📌マクロの中でマクロを呼び出すことも可能だ。
// マクロ定義
// 服装を定義して……
DEF(SPECIAL_BLAZER=yellow bowtie, red blazer, white skirt,)
// GIRLの定義でSPECIAL_BLAZERを使う
DEF(GIRL=1girl, green eyes, blue hair, SPECIAL_BLAZER)
// プロンプトにこう書くと……
GIRL
// 内部でこのように置換される
// 1girl, green eyes, blue hair, yellow bowtie, red blazer, white skirt,
他の服装のマクロをセットすれば、手軽に着せ替えが可能だ。
これはシンプルな例だが、「GIRL」の定義にさらに別のマクロを入れることもできるし、「SPECIAL_BLAZER」の内容を「上半身 下半身 アクセサリー」のような複数のマクロを組み合わせたものにしてもいい。
⚠️すこし気になるのは「無限ループさせたらどうなるのか?」ということだ。
これはしっかり対策されていて、「マクロAの中でマクロBを使用し、マクロBの中でマクロAを使用する」とエラーで停止する。
この例なら「SPECIAL_BLAZER」の定義の中に「GIRL」を書けば必ずエラーになる。
かなり複雑なマクロを書かない限り起きないと思うが、万が一発生してもComfyUIがフリーズしないので安心して利用できる。
タグ以外の使用
📌「PC: Schedule Prompt」ノードでは、DEFはプロンプト解析処理の一番最初に処理される。
だから、こんな風にマクロでCOUPLEキーワードを呼び出すことも可能だ。
// マクロ定義
DEF(LR_L=COUPLE(0 0.45))
DEF(LR_R=COUPLE(0.55 1))
DEF(GIRL=1girl, yellow eyes, orange hair, serafuku,)
DEF(BOY=1boy, blue eyes, blue hair, school uniform,)
// マクロ使用部分
friends,
LR_L
GIRL
sitting,
LR_R
BOY
standing,これは内部でこう置き換わる。特に難しくはない。
friends,
COUPLE(0 0.45)
1girl, yellow eyes, orange hair, serafuku,
sitting,
COUPLE(0.55 1)
1boy, blue eyes, blue hair, school uniform,
standing,
「2girls」のように「1boyと1girl」を示す純粋なタグが探せなかったので(=hetero、coupleなどなんらかの関係性が加わってしまうので)、とりあえずfriendsにした。
「1boy, 1girl, 」と書いて、左エリアに「うっすら1boy,」、右エリアに「うっすら1girl,」と影響が出ることを避けたかったのだ。
横3分割ならこう書けばいい。
// Left Center Right配置のLeft。以下同じ
DEF(LCR_L=COUPLE(0 0.3))
DEF(LCR_C=COUPLE(0.4 0.6))
DEF(LCR_R=COUPLE(0.0.7 1))上中下も同様に。UCD_U~UCD_D(Up、Down)でもUCD_A~UCD_B(Above、Bottom)でもお好きな方で。
⚠️もっとも、マクロにしてしまうと「0.3や0.7の部分を手軽に変更できなくなる」というデメリットも生じる。
一応、次に説明する「パラメータを含むマクロ」で解決はできるのだが……覚えることが増え、複雑になってしまう。
comfyui-prompt-control自体もそうだが、常に使おうとせず、使うメリットがデメリットを上回る状況でだけ使えばいい。
単純な分割指定なら他の分割描画ノードを使う方が楽なこともあるだろうし、逆にそうしたノードで「1枚ごとに分割状態を変えて連続生成」「AREAを一瞬だけ使ってCOUPLEに切り替える」といった処理をするのは大変だ。
臨機応変、適材適所ということである。
シンプルなDEFだけでも役立つ場面はある。混乱しそうなら手を広げすぎないのも一つの選択だ。
引数(パラメータ)の使用
さらにドキュメントを読んでいくと、任意の引数(パラメータ)を渡す方法も書いてある。
📌マクロの使用時に「マクロ名()」という形にして、「()」の中に「;」区切りでパラメータを書いていけばいい。
定義の「マクロの内容」部分では、それを先頭から順番に$1、$2という表記で参照できる。
もっと簡単な言葉で言えば、$1や$2を書いた位置に、その数字に対応する(○番目の)パラメータが埋め込まれるわけだ。
// マクロ定義
DEF(TAG_STOP=[$1::$2])
DEF(TAG_START=[:$1:$2])
// プロンプトにこう書くと……
TAG_STOP(car; 0.5)
TAG_START(1girl; 0.3)
// 内部でこのように置換される
// [car::0.5]
// [:1girl:0.3]
タグを消して(弱めて)背景化させて……
それと入れ替わりに1girlを描く。内容はごく普通の処理だ。
🤖「これ、むしろ入力量が増えていませんか?」 そう、これはあくまでも説明のためのシンプルな例であって、実用性はない。
生のスケジューリング書式よりも「ミスしにくく、何をしているかわかりやすい」というメリットはあるが……。
より現実的なサンプルも考えてみよう。
// マクロ定義
DEF(TAG_FADE=[($1:$2):($1:$3):$4])
// プロンプトにこう書くと……
TAG_FADE(1girl, smile, open mouth, waving; 1.2; 1.0; 0.3)
// 内部でこのように置換される
// [(1girl, smile, open mouth, waving:1.2):(1girl, smile, open mouth, waving:1.0):0.3]これは「一瞬だけAREAを使う」時に、「最初に強くシルエットを描かせる」ことを狙ったスケジューリングだ。
ただし、強度1.2や1.3にしたからといって確実に低ステップでシルエットが完成するとは言いきれない。逆に人ならざる何かを爆誕させる可能性もある。打率アップのための試行錯誤における一手法にすぎない。
1.2→1.0という変化を基本的に変更しないなら、マクロ名部分に初期値を書いておけばいい。
// 1.2→1.0の部分を省略できるように、3番目($3)と4番目($4)に変更する
// さらに「TAG_FADE(; ; 1.2; 1.0)」の部分で初期値を設定
DEF(TAG_FADE(; ; 1.2; 1.0)=[($1:$3):($1:$4):$2])
// 普段はタグ群を書いて、0.3の部分だけを調整すればいい
TAG_FADE(1girl, smile, open mouth, waving; 0.3)
// 実行時の結果:省略した3番目と4番目は自動的に初期値(1.2と1.0)が使われる
// [(1girl, smile, open mouth, waving:1.2):(1girl, smile, open mouth, waving:1.0):0.3]
// 必要に応じて1.2→1.0の部分も調整できる
TAG_FADE(1girl, smile, open mouth, waving; 0.3; 1.3; 0.8)
// 実行時の結果:それぞれ強度1.3、0.8になる
// [(1girl, smile, open mouth, waving:1.3):(1girl, smile, open mouth, waving:0.8):0.3]なお、初期値が書かれていない部分を省略すると空白のままになる。
このサンプルでは$1と$2、つまり1番目と2番目の引数も省略すると「[(:1.3):(:0.8):]」と変換される。
ここでは数値が多めだが、$1の部分のように文字列もパラメータとして使える。
自然言語の一部を$1や$2にしておいて、外部から与える……という使い方もすぐ思いつくだろう。
正直、この辺りはasagi4氏のようにコーディングをする人間から見た「便利さ」なので、難しいと感じたら無理に取り入れる必要はない。
2ヶ所ぐらいならコピペして両方を手で書き換えた方が早いケースもあるだろう。
しかし、それが3~4ヶ所になってきたらどうだろうか? すべてを同じ状態に維持するためのコストが大きくなれば、いつかミスが起きてしまうのでは? ……そんな不安が出てきてから検討すれば十分だ。
マクロの注意点
📌マクロの使用時、存在しないマクロ名を書いても(またはマクロ名を書き間違えても)エラーにはならない。
マクロ名のミスに見えても、実はタグや別のカスタムノード用のキーワード……という可能性もあるから(その判断が不可能だから)、うかつに止めることはできないのだ。
たとえば、先のサンプルの「BG_CLASSROOM」をうっかり「CLASSROOM」と書いてしまうと「classroom」タグだと解釈される。
まずいのはclassroomという概念にschool deskやschool chairが含まれていることだ。結果、しばらくミスに気づけないということもありえる。
外見・服装マクロなども同様に「マクロが機能していないのに、偶然一部の色やアイテムがうまく出力されてしまう」といった状況があることに注意しよう。
別の問題もある。
📌現代の開発環境ならマクロの上にカーソルを置けば内容が表示されるし、定義にジャンプして編集するのも簡単だ。だが、DEFではそうもいかない。
内容の確認・編集は自分でそのノード(または定義一覧を書いたファイル)を見に行くことになるし、実行時にどう変換されるか忘れてしまったら、やはり確認しに行くしかない。
たとえば、こんな風に定義一覧をまとめたノードを作り、本来のプロンプトの前に連結して使うとしよう。
マクロ名をタグ補完のユーザー候補として登録しておけば入力の負担も少なく、プロンプト本体部分もスッキリ短くなる……のだが。

使いこなせれば非常に便利なはずだ。
しかし、マクロの内容を忘れてしまうと逆に効率が悪くなってしまう。いちいち定義ノードで内容を調べなければいけないからだ。
それでも、見えていれば(探す時間はかかるが)対応はできる。だが、マクロ定義部分をファイルから読み込むようにした時、左のプロンプトが右の変換結果に脳内翻訳できるだろうか?

だからタグ群や長文の永続的な登録に使う場合は、本当に頻繁に使うもの・絶対に忘れないものに絞るか、なんらかの「思い出すための工夫」が必要だ。
翻訳を表示してくれるタイプのタグ補完ノードを使って、翻訳部分にマクロの内容を書くとか……。
📌現実的に考えるなら、マクロは1プロンプト内で繰り返し登場する数値やタグ群の「一時的な」登録用と割り切って使った方がいいように思える。
この使い方を固めてから、まだ記憶力に余裕があるなら永続的な登録を考えてみてはどうだろうか。
まとめ
今回はcomfyui-prompt-controlの「PC: Schedule Prompt」ノード、または「PC: Expand Macros」ノードで使えるマクロ機能を確認した。
ポイントは次の3点だ。
📌マクロは「DEF(マクロ名=内容)」の形で定義し、それ以外の場所で「マクロ名」を書くと「内容」に置換される。
通常はこれだけ覚えておけば間に合うだろう。
📌マクロの「内容」の部分に「$1」「$2」「$3」などを書くと、「マクロ名(○○; ○○; ○○)」のように「;」区切りで記述された部分を使用できる。
こちらは必要になった時に思い出せれば十分だ。
📌マクロの中に別のマクロを含めることもできる。
細かいパーツマクロを組み合わせることで、柔軟にマクロが作れるのは魅力的だ。
⚠️マクロは便利だが、使えば使うほどプロンプトの把握は難しくなっていく。
時間を置いてから見返した時、「これ、どういう意味だっけ?」と悩んでしまうようでは意味がない。「すぐ内容が思い出せるか? メンテナンスできるか?」を常に意識して使うといいだろう。