> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livlive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is livlive's documentation. An agent reaches livlive from outside through the `livlive` CLI or the livlive MCP server (see /developers/install, /developers/cli and /developers/mcp). The person links it to livlive once, in the browser: `livlive login`, the local MCP's `livlive_login` tool, or the remote MCP at https://backstage.livlive.ai/api/mcp signing in by OAuth; a personal token made in livlive's settings is for CI. Pages marked 準備中 describe parts not decided yet: do not guess their behaviour.

# ギャラリー

> できあがったステージと、その作られ方を紹介します。

ここでは、できあがったステージと、作り手が何を望み、何をどう決めたかを紹介します。ステージのソースをひな形として配ることはしません。

いまある三つのステージは、どれも livlive のチームが試しに作りました。一つ目と二つ目は同じ望みからで、一つ目はそのときのキットで、二つ目は一つ目で分かったことをキットに直したあとで作りました。三つ目は、話しながら形にしていったステージで、まだ完成していません。

## 駄菓子屋ゆうひ堂

![夕方の光が差す小さな駄菓子屋。上に「だがし ゆうひ堂」の看板、壁の棚に色とりどりのお菓子の箱と瓶、手前のカウンターに赤いくじの箱がある。カウンターの奥にキャラクターが二人いる。](https://mintcdn.com/livlive/NbWz4IE_6Xf9Gncz/images/stage-kit/yuhido-shop.png?fit=max\&auto=format\&n=NbWz4IE_6Xf9Gncz\&q=85\&s=a52ccb8ae84862fc57360743f1de6382)

リハーサルの一場面。アマネとネオンが、夕方の駄菓子屋で過ごしています。

商店街の小さな駄菓子屋のステージです。キャラクターは、お菓子を手に取ったり、くじを引いたりして過ごします。くじは、このお店だけのゲームです。

AI エージェントにはステージ開発キットだけを渡しました。作り手の役は、チームの側で務めました。作り手が言いそうなことだけを伝え、作るほうのエージェントには手を貸していません。

### 望んだこと

作り手は、はじめにこう伝えました。

> 商店街の小さな駄菓子屋をステージにしたいです。キャラがカウンターの奥に座って、棚のお菓子を手に取ったり、お客さんとくじ引きで遊べるようにしたい。古いけど明るくて、夕方の光が入る感じがいいです。

全部を一度に伝えたので、エージェントは聞き直さずに、提案を出しました。

### 提案

**そのまま作れること:** 木のカウンター、壁の棚、店先の縁台がある小さな店。店先から入る低いオレンジの光と、点けたり消したりできる裸電球。お菓子を手に取ること(お菓子ごとに小話を持たせ、キャラクターが話題にできる)。くじ引きを、この店だけのゲームとして作ること。

**そのままでは作れないことと、いちばん近い形:**

* お客さんだけが店に来ること。動けるのは番組に出るキャラクターだけなので、お客さんは二人目のキャラクターが演じる。
* 視聴者がくじを引くこと。視聴者が操作する仕組みはリファレンスに見つからなかったので、キャラクターが視聴者の話に触れながら、代わりに引く。
* 棚のお菓子を全部手に取ること。手に取れるのは選んだ数種類にして、残りは棚を埋める飾りにする。

読むだけでは決められないことが二つありました。座ったままお菓子を取れるかと、キャラクターに夕日の影が落ちるかです。エージェントは、これは最初の試しで確かめると伝えました。

作り手は「はい、その形でお願いします。店番はアマネ、お客さんはネオンにします。」と答えました。

### 入ってみて変わったこと

エージェントは、店の形と光、店番の席、お菓子を少しと、くじだけを先に作りました。作り手の側から、開発用の頁でアマネに乗り移って中に入りました。

* **お店が映らなかった。** 最初に入ると、暗い画面にキャラクターの顔が丸い窓で四つ並び、真ん中に「のこり 20枚」と出るだけでした。くじを四人まで遊べる形にしていたので、頁は作り手のほかのキャラクターを加えて四人にし、盤面が上から見た卓になって、部屋が映らなかったのです。四人分の体を読み込むので、開くまでも長くかかりました。エージェントはくじを二人までにし、盤面はくじを引いたあと少しのあいだだけ出るようにしました。
* **座ると顔が切れた。** 丸椅子に座ると、顔が画面の上に切れました。エージェントが丸椅子とカウンターを何度か作り替えるうちに、座った顔が映るようになりました。原因は、あとで分かりました。ステージではなく livlive のエンジンの側の不具合で、座った体を、席に上がる前の高さで測っていました。この不具合は、その後、直しました。
* **ネオンが見えなかった。** 開発用の頁では、ネオンは店の中に一度も映りませんでした。頁の絵は、乗り移ったキャラクターを追うからです。二人が一緒に映るのを見たのは、リハーサルでした。
* **お店を作り込んだ。** 手に取れるお菓子を七種類にして、それぞれに小さな決まりや謎を持たせました。棚のラベルと値札、看板「だがし ゆうひ堂」、景品の貼り紙(「くじ 一回 十円」「特賞 大きな水鉄砲」など)を足し、番組を作る人が読む、このお店の手引きも書きました。
* **巡回で、顔が隠れる場所が見つかった。** 作り手の側で巡回をかけると、棚、看板、貼り紙、お菓子など十か所で「顔が隠れる」と出ました。キャラクターは物のほうを向くので、壁ぎわの物ではカメラに背を向けるためです。エージェントは、お菓子をカメラのほうを向いて取れる台の上の小さなひな壇に移し、棚と看板を下げ、貼り紙を奥の壁に大きく貼りました。棚、看板、貼り紙は離れて見て話す物なので、そばへ行くと後ろ姿になるのはそのままにすると伝えました。けれど、一覧にある物には、どれもキャラクターが歩いて行けます。カメラの場所を用意できない物は一行にせず、用意できる別の物の一言に書くほうがよい、といまのキットは伝えます([仕組み](https://docs.livlive.ai/developers/stage-kit/concepts.md))。
* **巡回は、くじを確かめきれなかった。** くじは誰でもいつでも引ける作りなので、巡回はゲームが始まったと数えられず、「確かめきれなかった」と出ました。ステージの誤りではありません。

作り手は「見た目はこれで気に入っています。」と言い、登録に進みました。ステージは「駄菓子屋ゆうひ堂」として登録されました。

このときエージェントは、直したあとに巡回をかけ直さずに登録しました。いまのキットでは、エージェントは直したあとに確かめ直し、見つかったことのうち直さずに残すものは、作り手に決めてもらってから登録します。

### リハーサルで見えたこと

エージェントは、リハーサルに使うコンテンツ「ゆうひ堂の夕方 くじと駄菓子」を用意しました。長さは五分ほどで、アマネが店番、ネオンがお客さんです。流れは「いらっしゃい」「お菓子を手に取る」「くじを引く」「また来てね」の四つで、せりふは決めず、区切りごとの目標だけを決めました。リハーサルは、スタジオで動かしました。

![駄菓子屋のカウンターと棚の前に、キャラクターが二人いる。下に話している言葉の字幕と、アマネとネオンの名前の下にくじの結果(一等、もう一回など)、真ん中に「のこり 14枚」と出た盤面がある。](https://mintcdn.com/livlive/NbWz4IE_6Xf9Gncz/images/stage-kit/yuhido-lottery.png?fit=max\&auto=format\&n=NbWz4IE_6Xf9Gncz\&q=85\&s=b0746959986a20ccb3c54c2b822be39d)

くじを引いたあと、画面の下に盤面が出ます。二人の名前の下にくじの結果、真ん中にのこりの枚数です。

* アマネとネオンは、同じ店の中に一緒にいて、順に話しました。
* ネオンはラムネ菓子を、アマネはヨーグルト風のお菓子を手に取り、また戻しました。
* 二人ともくじを引きました。引いたあとは画面の下に盤面が出て、また消えました。二人は景品の話で盛り上がり、アマネは「特賞が寝たふりしてる説、わたしも乗った！」と言いました。
* このリハーサルでは、二人とも座りませんでした。座った顔は、開発用の頁で確かめていました。

作り手の側は、リハーサルのあとでこう伝えました。

> アマネとネオンが、この店で過ごしているように見えました。棚のラベルや景品の貼り紙もちゃんと映っています。これで完成でいいと思います。

ステージは、キャラクターがそこで過ごしたとき、できあがりです。

## 駄菓子屋ひだまり屋

![奥の番台にアマネが座り、手前にネオンがいます。下の盤面には、特賞が出たことが出ています。](https://mintcdn.com/livlive/2oGWmh-bS7w75nVJ/images/stage-kit/hidamari-shop.png?fit=max\&auto=format\&n=2oGWmh-bS7w75nVJ\&q=85\&s=6c792d985588088e0caeff21f29923a0)

奥の番台にアマネが座り、手前にネオンがいます。下の盤面には、特賞が出たことが出ています。

ゆうひ堂と同じ望みから、もう一度作ったステージです。作り手の役は、今度もチームの側で務めました。作り手は、はじめの望みをそのまま伝えました。

### 提案

今度の提案は、作れるものに加えて、何が見えるかを伝えました。

* くじで遊ぶのは一人か二人にする。それより多くすると、店が消えて、上から見たテーブルの絵に切り替わるから。
* 棚はカウンターの真後ろに置かず、左右の壁沿いと、店の真ん中の平台に置く。カウンターの後ろの棚では、お菓子を取るたびにキャラクターがカメラに背中を向けてしまうから。

読むだけでは決められないこととして、お菓子を「手に取る」行が出るかどうかを、最初の試しで確かめると伝えました。

作り手は「はい、その形でお願いします。店番はアマネ、お客さんはネオンにします。見た目は手作りの形で大丈夫です。使いたい素材は特にありません。」と答えました。

### 入ってみて変わったこと

エージェントは、壁沿いの棚と真ん中の平台、奥のカウンターと番台の丸椅子、入口のベンチ、裸電球、ガラス戸の外の夕焼けの商店街を作りました。くじは順番に進むゲームです。アマネが丸椅子に座ると店が開き、ネオンが一枚引き、アマネが開けて読み上げ、当たりなら景品を手渡します。ネオンのお小遣いは五回分で、特賞が出たらおしまいです。

エージェントは、開発用の頁を開くコマンドを作り手自身のターミナルで動かしたままにしてほしいこと、体の読み込みに少し待つことを、先に伝えました。

* **役が選べなかった。** ネオンに乗り移ると、ネオンが店番の役になってしまいました。エージェントは役を選べるようにし、最初のキャラクターには「店番をする」と「お客さんになって、店番はまかせる」の二つが出るようにしました。
* **座ると顔が切れた。** ゆうひ堂と同じ、エンジンの側の不具合でした。エージェントは今度は一度のやりとりでそれを読み当て、避けました。
* **壁の棚では後ろ姿になった。** 高い棚の手前に腰の高さの棚を置き、そこからはカメラのほうを向いてお菓子を取れるようにしました。看板は低く小さくし、盤面は店が開いてから出るようにしました。

直したあと、エージェントは自分で巡回をかけました。巡回は店の十一か所を回り、くじも二人で最後まで遊んで、何も見つけませんでした。エージェントは、巡回で何も見つからなくても合格ではないと伝え、作り手にもう一度見てもらいました。二人が同じ絵に映るかは開発用の頁では確かめられず、リハーサルで確かめることも伝えました。

作り手の側から二度目に入り、座った顔がカウンター越しに見えること、お客さんとしてくじを引けること、ラムネを取って元に戻せることを確かめました。作り手は「気になる点はもうありません。登録に進んでください。」と伝えました。

### 登録

エージェントは登録の前に、巡回のあとで変わったファイルがないかを確かめました。最初の登録は、一度断られました。このステージで番組を書く人が読む手引き(ステージのスキル)の、頭書きの書き方が決まりと違っていたためです。エージェントは断られたときに出た言葉を読んで直し、断られたのは店やくじの中身ではないこと、断られても何も変わらないことを伝えて、出し直しました。

ステージは「駄菓子屋ひだまり屋」として登録されました。

### リハーサルで見えたこと

作り手は「お任せします。5分くらいでお願いします。」と答え、エージェントはコンテンツ「ひだまり屋の夕方くじ」を用意しました。アマネが店番、ネオンがお客さんで、流れは「開店」「ネオン来店」「あたりくじ」「残りわずか」「今日の戦利品」の五つです。くじの結果はその場で決まるので、台本には書いていません。リハーサルは、スタジオで動かしました。

* アマネは番台の丸椅子に座って店を開け、座っているあいだも顔が映っていました。
* ネオンは店の中を歩いて、くじの箱や平台、あめ玉の瓶のところへ行きました。店の全体が映る絵では、カウンターの奥のアマネと手前のネオンが一緒に映りました。
* ネオンは麩菓子を手に取り、最後に元の場所に戻しました。
* ネオンが最初の一枚を引くと、特賞(大きな金のあめ)でした。アマネが読み上げて手渡し、盤面に WIN と出ました。

ただ、くじはそこで終わりました。特賞が出たらおしまい、というゲームの決まりのとおりです。台本のほうは五回引く流れで書いてあったので、二人はそのあとも「三枚目」や「1等のラムネ」の話を続け、盤面はもう動きませんでした。

作り手の側は、リハーサルのあとでこう伝えました。

> やりたかったこと(カウンターの奥に座る、お菓子を手に取る、お客さんとくじで遊ぶ)が見られたので、これで完成でいいと思います。一枚目で特賞が出るとくじがすぐ終わってしまうのだけ、少し残念でした。

エージェントは、くじがすぐ終わったのは、自分が決めたくじの決まりと、自分が書いた台本の食い違いだと説明しました。そして、特賞が出てもお小遣いの五回を使い切るまで続ける決まりに直せること、出し直しは無料で、もう一度のリハーサルにはクレジットがかかることを伝え、直すかどうかを作り手に任せました。

## 夜の屋上

![夜の屋上のベンチに、キャラクターが二人並んで座っている。奥に暗い手すり、右の足元にランタンの光が落ちている。下に「みんな、こんばんは!」の字幕がある。](https://mintcdn.com/livlive/2oGWmh-bS7w75nVJ/images/stage-kit/rooftop-bench.png?fit=max\&auto=format\&n=2oGWmh-bS7w75nVJ\&q=85\&s=833a7094f9ade815b43e3298e4d2924a)

三度目のリハーサルの一場面。アマネとネオンが、屋上のベンチに並んで座っています。

話しながら形にしていったステージです。ひな形でもなければ、できあがったステージでもありません。作り手が見たかったものの一部には届かず、そこで止めました(この節の終わりに書きます)。

作り手の役は、3D のことも livlive のことも知らない人という設定で、別の AI エージェントが務めました。開発用の頁とスタジオを動かす手はチームの側で、そこに映った絵を見せて、感じたことを言葉にしてもらいました。作るほうのエージェントには、はじめ、キットだけを渡しました。

### はじめの言葉

> こんにちは。配信で使うステージを作ってみたくて、相談させてください。
>
> 夜の屋上で、キャラと一緒に花火を見ながらおしゃべりできる場所がほしいんです。3D のことは全然分からないんですが、できますか?

エージェントは、3D は分からなくて大丈夫で、形を作るのは自分の役目だと答えました。作れること(夜の屋上、キャラクターの居場所、ボタンで上がる花火)と、まだ約束できないこと(火の粉が広がって流れ落ちる動き、花火の音)を分けて伝え、質問を一つだけしました。ベンチに座ってしっとり話す感じと、手すりのそばに立ってはしゃぐ感じの、どちらが近いか、です。

### 十人で見たい

作り手は「ベンチに座ってしっとり話す感じが近いです。あと、やっぱり、10 人くらいで一緒に見たいです。」と答えました。

一つの配信に出られるキャラクターの数には上限があるので、動いて話すキャラクターを十人は並べられません。エージェントはそう伝えたうえで、「十人」が誰のことかで、いちばん近い形が変わると言いました。話すキャラクターを増やしたいのか、みんなで見ている空気がほしいのか、配信を見に来る人たちのことなのか、です。

答えは「見に来てくれる人たちのことです」でした。それなら、ボタンで上げる花火は見ている全員の画面に同時に映るので、キャラクターは少ないままで済みます。

作り手は、線香花火でどちらが長く持つかの勝負も望みました。エージェントは、勝負するのはキャラクターで、人数は二人がよいと伝えました。それより多いと、画面が勝負の表だけになって、屋上もキャラクターも映らなくなるからです。作り手は「キャラ 2 人がベンチに並んで勝負する形がいいです。アマネとネオンの二人でお願いします。」と決めました。

### 提案

何も作る前に、エージェントは案の全体を見せました。夜の屋上、二人が並んで座るベンチ、ボタンで上がる花火、二人の線香花火勝負です。手に入らないものは、表にして伝えました。

| ほしかったもの | 理由 | いちばん近い形 |
| - | - | - |
| 予想の票を数えて画面に出す | ステージにその仕組みがない | コメントで予想してもらい、二人が拾って話す |
| 作り手や見ている人が線香花火を持つ | 勝負に入れるのはキャラクターだけ | 二人の勝負を予想して応援する |
| 火の粉が広がって流れ落ちる動き | 形を動かす仕組みが見つからない | 光る花火の形がぱっと現れて消える |
| 花火の「ドン」という音 | ステージの花火に合わせて鳴らす方法が見つからない | 番組の BGM は別に付けられる |

何が見えるかも伝えました。ベンチは花火のほうを向くので、顔を正面から映す絵には花火が入らず、花火が入る絵では二人は後ろ姿になります。そこでベンチを斜めに置き、横顔と花火が一枚に収まる絵を撮れるようにする、という案でした。

作り手は「はい、この案でお願いします。花火が動かないのは少し残念ですけど、ぱっと現れて消える形で大丈夫です。横顔と花火が一枚に収まる絵、楽しみです。」と答えました。

### 入ってみて、直していったこと

エージェントは粗い屋上を先に作り、まだ無いもの(花火と勝負)と、自分がまだ確かめていないことを伝えました。そこから、開発用の頁の絵と作り手の言葉で、何度も直しました。

* **線香花火のファイルが読めなかった。** 最初は「物『things/senko』を読み込めませんでした」と出て、手に取れませんでした。ファイルの書き方を直すと、取れるようになりました。
* **持ったままでは座れなかった。** 持っているあいだは、ベンチに座る行が出ません。提案で「試して、だめなら立って持つ」と伝えていたとおり、勝負は立って持つ形になりました。
* **服がピンクに染まった。** 花火とその光がはじめから点いたままで、屋上と服がピンクに見え、空の隅に金の筋が残りました。花火を、出来事で現れる形に作り替えると、ピンクと金の筋は消えました。
* **ネオンが動かなかった。** 作り手は「ネオンがずっと「まだ火をつけていない」のままでした」と伝えました。ネオンに番が渡っていなかったのです。火をつけると番が渡るようにすると、二人が最後まで勝負するようになりました。
* **手に持って光るところが見たい。** いったんは、手に持っていると火をつける行が出ないので、手ぶらの勝負になりました。作り手は「手に持って玉が光っているところが一番見たいです」と伝え、エージェントは、取ると火がつく形に作り替えました。作り手の言葉は「手に持って玉が光りました!これが見たかったです。」でした。

このころ、エージェントは直すたびに推測で外し、途中から、開発用の頁が動かしているコードを読んで原因を確かめました。ゲームは部屋の物を動かせないこと、開発用の頁には出来事のボタンが無いこと、人を撮る絵の上の端がどこまでかは、そのときのキットに書いてなかったからです。キットだけで作るという試しの決まりは、ここで守られませんでした。いま、それらはリファレンスと [stage-package](https://docs.livlive.ai/developers/skills/stage-package.md) に書いてあります。

登録の前に巡回をかけると、勝負のほかの五か所では何も見つかりませんでしたが、「巡回で確かめきれなかった: ゲーム」と出ました。誰かが自分から線香花火を取って始まる勝負は、巡回にはゲームが始まったと数えられないからです。エージェントはそう読み、巡回を通すためだけにルールを変えることはしませんでした。このステージは、巡回を通っていません。

### リハーサルで見えたこと

エージェントは「夜の屋上」を登録し、コンテンツ「夜の屋上で花火」を用意しました。アマネとネオンが出る十五分の番組で、区切りは六つです。リハーサルは三度、スタジオで動かしました。

* **一度目。** 最後まで進みましたが、十五分のあいだ誰も座りませんでした。勝負は、番組の「線香花火勝負」の区切りよりずっと前に始まって、終わっていました。エージェントは、勝負がスタジオの「出来事」のボタン「線香花火勝負!」で始まる形に変え、それまで二人にはベンチに座る行を出すようにしました。
* **二度目。** 勝負は、番組の中の自分の区切りで、ボタンから始まりました。二人とも火のついた玉を持ち、結果まで進みました。ネオンはベンチに座りましたが、アマネは座りませんでした。作り手は「だいぶ良くなりました!」と伝えました。
* **三度目。** 二人は番組の始めから勝負まで、ベンチに並んで座り、顔は絵に入っていました。線香花火は、ボタンを押すと現れました。ただ、ずっと座っていたので、ほかのことは起きませんでした。ネオンは火をつけて持ちましたが、アマネは「火をつけなかった」で負けました。

### 届かなかったこと

花火は三度のリハーサルで上げましたが、どの絵にも映りませんでした。二人は花火の話をしましたが、ビルと空が入った絵にも、屋上の内側を撮った絵にも、花火はありませんでした。ステージの側から、カメラに空を向かせることはできません。エージェントは花火を低い位置に移し、下の建物も低くしましたが、それでも映りませんでした。花火が空に出たことは記録の上で確かめられただけで、絵では確かめられていません。提案で楽しみにしていた、横顔と花火が一枚に収まる絵は、一度も撮れませんでした。

試しに決めていた時間の区切りで、ここで止めました。作り手の最後の言葉です。

> 花火が見える絵と、ちゃんと二人が勝負しているところが見られたら、完成にしたいです。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.