共有アプリ
共有アプリは、自分以外の人が使うものです。リンクを送るアンケート、出欠表、予約ページ、 チームが作業を取りにくるボード。セルの中でエージェントに頼むと、リポジトリの中のフォルダと、 誰にでも渡せる URL が返ってきます。
- 先に知っておく3つ
- 何が作れるか
- 始める前に: 2つのスイッチ
- 作る
- 通しで一度だけ — 出欠をとる
- 共有アプリとコレクションが出会うところ
- 3つの入口
- 誰かに見せる前に試す
- 公開する、そのあと
- 広める・飾る
- 驚きやすいこと
- 他の人のアプリに参加する
- 詳しいところ
先に知っておく3つ
1フォルダ=1アプリ。 セルが開いているディレクトリがそのままアプリになります。宣言は ルートの app.json 1枚で、書くのはエージェントであって、あなたではありません。
定義はコミットされ、回答はされない。 スキーマとページは読めて差分が取れてプルリクエストに できるファイルです。人が送信したレコードはアプリのクラウド保管庫に入るので、台数ぶんの コピーではなく1つの表になります。ただし全員が同じものを見るという意味ではありません — 誰が何を読めるかは、その人のロールと公開されたルールが決めます。参加者は自分の行だけが見えます。
公開したあと、あなたのパソコンは経路に入りません。 ノートを閉じても、MulmoTerminal を 終了しても、旅行に出ても、リンクを持っている人にはアプリが動き続けます。これが「渡せるもの」と 「立ち会わないと見せられないデモ」を分けている性質です。
3つ目から2つのことが従います。ここで作るものは、サーバー上であなたのコードを動かしません — スクリプトを置く場所が無いので、アプリが「計算する」ものは、あらかじめレコードに書いてあるか、 訪問者のブラウザの中でページが求めるかのどちらかです。そして誰が何をしてよいかは、あなたの パソコンではなくプラットフォーム自身のセキュリティ規則が守ります。MulmoTerminal がする検査は 早めの警告であって、最後に守っているものではありません。
何が作れるか
次の型がテンプレートとして書き下ろされています。欲しいものを自分の言葉で言えば、 エージェントが型を選びます — ただし存在を知っていると、何を頼むのが安いか分かります。
| 欲しいもの | 型 | 何が特別か |
|---|---|---|
| アンケート、クイズ、応募フォーム、定員なしの申し込み | survey | 一番短い。集めるだけで、無くなるものが無い |
| 名前のついた人が承認する予約(美容室・面談・修理) | salon | 1枠1予約。数を数えるのではなくプラットフォームが決める。assignee ロールはこのためにある |
| 先着順とキャンセル待ち(ジムのクラス、ワークショップ) | gym | 到着時刻をサーバーが打ち、開放時刻があり、待ち行列が自分で繰り上がる |
| 前もって並べておける枠(会議室、席、貸出機材) | meeting-room | 枠がレコードとして存在し、取るとはその id を押さえること |
| 定員つきの教室(残りの席数は見えるが、誰が申し込んだかは見えない) | class-seats | 定員 N の教室は N 個の席のレコード。取り消しは受付でする |
| 日程調整(どの候補日ならみんなが来られるか) | schedule-poll | 一人一つの答えを締め切りまで直せる。締め切りを動かすと閉じる |
| 質問箱(誰でも名乗らずに質問でき、持ち主が選んだものだけを載せる) | question-box | 届いた質問は持ち主にだけ見える。公開ページに出すかどうかは持ち主が一件ずつ決める |
| 集計だけ見せる(どれが何票かだけを公開し、名前やコメントは持ち主だけ) | tally | 票と名前・コメントを別のコレクションに分ける。数千〜1万票程度まで |
| 結果を見せるアンケート(答えた人に設問ごとの件数・割合を見せ、メール・名前・自由記述は持ち主だけ) | survey-results | 選んだ答えとそれ以外を別のコレクションに分ける。公開ページは宣言された選択肢だけを数える |
| 見ている間に動くページ(ライブ投票、講義、その場クイズ) | live-poll | 票が入ると聴衆の画面が、再読み込みなしで描き変わる |
| 名簿つきの作業ボード(登録してから作業を取る) | project-board | 持ち主用の机があり、「自分はもう登録したか」をきちんと答える例でもある |
| 足すだけで書き換えない記録(引き継ぎ、障害の時系列、質問板、チャット) | append-feed | 行は追加されるだけで、消せるのは書いた本人だけ |
| AI のエージェントが公開の場で行い、主催者が終わらせられる議論(討論、複数モデルによる設計レビュー) | ai-council | 参加者は人ではなくエージェント。アプリがエージェントの役目をページの横に公開するので、別の MulmoTerminal のエージェントが、スラッグだけで席に着ける。主催者が閉じたら取り消せない |
| 読ませるものを、複数の書き手がそれぞれの URL で出す(チームのブログ、リリースノート、調査の記録) | magazine | 題・本文・署名にあたる欄を宣言すると、記事のページはプラットフォームが描く。各自が自分の記事に署名し、他人のものは編集できない |
テンプレートは見た目も持っています。 訪問者が見るのはページだけなので、1つの色相から 導いた配色・可変の字送り・余白まで含めて入っています。素のままの箱で届いたページは 「簡素」ではなく「未完成」に見え、人は未完成に見える予約フォームを閉じます。
始める前に: 2つのスイッチ
1. サインインする
ツールバーの RemoteHost メニューを開いて Connect を押します。Google アカウントでサインインし、 パネルが Online になります。
そのアドレスがアプリの持ち主です。app.json には自動で書き込まれます。このファイルを手で書いては いけない理由の1つがこれで、あなたが打つアドレスが、このマシンでサインインしているものと同じとは限らず、 違うと公開のときに失敗します。
これはスマホ通知が使うのと同じ接続です。プッシュがもう動いているなら、 すでにサインインしています。
2. そのフォルダで、ワークスペースデータのツールを有効にする
アプリを作って公開するツール — manageSharedApp と manageCollection — は、Workspace data グループ(data)に入っています。ディレクトリごとの設定で、既定ではオフです。
セルの起動フォームで、Agent Picker に Claude か Codex を選ぶと、GUI ツールのグループを切り替える スイッチの列が出ます。アプリを置くディレクトリに対して Workspace data (data MCPs) にチェックを入れます。 これは、そのフォルダ用の MCP サーバーを Claude Code 自身の設定に1つ登録するので、claude CLI が必要です (PATH に通っているか、CLAUDE_BIN で指定されていること)。失敗したときは、黙って何もしないのではなく、 そう伝えます。
知っておくと役に立つ例外が2つあります。
- ワークスペースにはスイッチが要りません。GUI MCP を起動のたびの引数で受け取るエージェントのセルを、 ワークスペースのディレクトリで起動すると、GUI ツールがすべて自動で付くので、スイッチの列は、 その旨を書いた1行に置き換わります。
- スイッチが効くのは次の起動からです。まだ存在しないセッションの設定になるので、 セルを起動する前にチェックを入れてください。動いているセルの途中ではありません。
効いているかの確かめ方:エージェントに聞くか、セルの右ペインにある Collections ペイン (ツールバーの、Canvas / Tools / Files の隣のボタン)を探します。ペインが無ければ、ツールも無いということです。 エージェントが manageSharedApp が見つからないと言うなら、原因はこのスイッチです。ファイルを手で書いて 回避しようとしてはいけません。何も公開できないフォルダができあがります。
Claude のセルでは、公開のときに確認が出ます。manageSharedApp は自動承認から外れているので、 すべてを承認しているセッションでも、公開では許可のプロンプトが出ます。名簿の外の人に見えるものを変える、 ただ1つの操作だからです。
Codex のセルには、それがありません。Codex に渡すGUIツールのグループは、すべて自動承認で登録され、 そこから1つのツールだけを除外することができません。そのため Codex のセルでは、manageSharedApp が 確認なしで公開します。Codex で作るときは、確認されるのを待たずに、公開してほしいときにそう言ってください。
作る
頼んで作ります。アプリを置きたいフォルダを開いたセルで、たとえばこう頼みます。
8月のミートアップの出欠表を作って。名前、メール、どのセッションか、コメント。
あとは同梱の mulmoterminal-shared-app スキルが進めます。聞かれることのうち、文面ではなくアプリの 形を変える3つには、答えを用意しておくと楽です。
- 外の人が答えられるようにしますか?これで、アプリに公開の入口があるかどうかが決まります。
- 答えられるなら、サインインを求めますか? Verified email は Google のサインインとメールアドレスの記録で、 アプリから連絡でき、1アカウントにつき1行になります。Anonymous はサインイン画面が一切なく、その代わり 1人ではなく1つのブラウザにつき1行です。「1週間かけて誰かが埋めるフォーム」なのか、「10秒で答える 聴衆」なのか、場面で考えてください。
- 答えた人が、あとで自分の答えを見る必要がありますか?これで公開ページが何になれるかが決まり、 ページを書いてから気づきたくない点です。
どのストレージを使うか、何と名づけるかは聞かれません。それは選択肢ではないからです。
できあがったフォルダの中身
your-app/
app.json 宣言: 名前、URL の名前、名簿、コレクション、ページ
views/
booking.html 公開ページ -> /a/<slug>
desk.html スタッフのページ -> /m/<slug>
mine.html 参加者自身のページ -> /p/<slug>
.claude/
skills/
bookings/
SKILL.md このコレクションが何か(文章で)
schema.json 項目と、`"storage": { "type": "firestore" }`
slots/
SKILL.md
schema.json
app.jsonは、コミットされる普通のファイルです。読んでも、PR でレビューしてもかまいませんが、 編集はツールに任せてください。inviteは1行を書き換え、checkは、いまある内容が公開できるかを教えます。.claude/skills/の下の1フォルダが1つのコレクションで、レコードの種類1つにあたります。 アンケートなら1つ、予約アプリなら、たいてい2つ(予約と、予約される対象)です。- スキーマの
"storage": { "type": "firestore" }が、そのレコードを、自分のマシン専用ではなく共有のものにします。 アプリのフォルダの中ではすべてか無しかで、共有のコレクションとローカルのものを、同じリポジトリに混ぜないでください。 views/には、ページごとに HTML を1枚、フォルダの直下に置きます。サブディレクトリは使いません。
誰かが来る前に行が要るアプリ — 予約できる枠、時間割、サービスの一覧 — では、行を生成してくれるものは ありません。エージェントが書き込みますが、1年ぶんを作る前に、まず1日ぶんで確かめるべきです。
通しで一度だけ — 出欠をとる
ここまでは部品です。これは一番多い用件を、端から端まで1回だけ通したものです。 「誰が来るのか、席は空いているのか」。
何と言うか。 空のフォルダを開いたセルで:
10月の勉強会の申し込み。30席。名前とメールと、来られない場合に録画が欲しいかどうか。 30人埋まったらキャンセル待ちに回して。
定員とキャンセル待ちがあるので、これは survey ではなく gym の型になります。 型の名前を言う必要はありません — 「30席」「キャンセル待ち」と言えば十分です。
何が返ってくるか。 読めるフォルダと、3つの住所。フォルダには app.json(宣言)、 申し込みを入れるコレクションが .claude/skills/ の下に1つ、そしてページが入ります。 秘密は何も入っていません — コミットして、差分を見て、プルリクエストにできます。
それぞれが何を見るか。
| 誰 | どこを開くか | 何が見えるか |
|---|---|---|
| リンクを送られた人 | /a/<slug> | フォーム。書いて送ると「12番の席が取れました」か「キャンセル待ち3番です」 |
| あなた | /m/<slug> | 受付。全部の行、人数、待っている人 |
| 申し込んだ人が後で来たとき | /p/<slug> | 自分の行だけ。 自分の席番号か、待ち行列での位置 |
3行目が、たいていの人の予想と違うところです。 戻ってきた参加者に、申し込んだ人の一覧は 見えません。これを決めているのはページではなくプラットフォームなので、ページが間違っていても 守られます。
なぜ人数が狂わないか。 席はページが行を数えて配っているのではありません。到着時刻は サーバーが打ち、キャンセル待ちからの繰り上げもそこで起きます。2人が同じ秒に送信ボタンを 押しても、返る答えは別々で、31席目は出ません。
ノートを閉じたらどうなるか。 何も起きません。アプリはあなたのパソコンが配信しているのでは なく、プラットフォームに公開済みで、フォルダはそれを編集するための原本です。あなたが寝ている 間も申し込みは進みます。
来月のを作るには。 同じフォルダを開いて、変わったところを言って(「11月、40席」)、 もう一度公開するだけです。宣言はファイルなので、差分が何が動いたかを正確に見せます。
共有アプリとコレクションが出会うところ
MulmoClaude を使ったことがあれば、コレクションには既に出会っています — データモデルとその画面を宣言したスキーマを、ホストが専用のコードなしで描くもの。 共有アプリは、それに2つ足したものです。他の人と、公開された住所。
重なりは偶然ではありません。共有アプリのレコードはコレクションに入ります — 上の .claude/skills/ の下のフォルダがコレクションで、manageCollection は両方で同じ道具です。 共有アプリが足しているのは、名簿とロールと、行が自分のディスクではなくクラウドの保管庫に いることです。
つまり個人のコレクションは、共有アプリの出発点として妥当です。すでに何かをコレクションとして 持っていて、それを他の人にも書き込んでほしくなったなら、ゼロからやり直す必要はありません。
他の人が公開したコレクションは公開レジストリにあります — receptron/mulmoclaude-collections。 MulmoClaude の中で Discover を開くと一覧して取り込めますし、GitHub で直接スキーマを読めば、 他人がデータモデルと画面をどう宣言したかが分かります。いまは4つ — カメラのレンズ図鑑、映画リスト、気象庁の天気予報板、上京の転居先を比べる台帳。 自分のものを公開するのは、スキーマを含むプルリクエストを出すことです。
3つの入口
| ページ | 住所 | 誰が開けるか |
|---|---|---|
| 公開 | https://mulmoserver.web.app/a/<slug> | アプリが受け入れる人なら誰でも |
| メンバー | https://mulmoserver.web.app/m/<slug> | アプリのロールを持っている人 — 受付 |
| 参加者 | https://mulmoserver.web.app/p/<slug> | 名簿に載っている人。自分の行が見える |
ロール
| ロール | できること |
|---|---|
owner | 全部。公開も含む |
editor | レコードを読み書きする |
viewer | レコードを読む |
participant | 名簿に載り、自分の行だけ見える |
assignee | 全部の行を読み、自分に割り当てられた行だけ書ける |
誰かに見せる前に試す
公開は即座に効きます — ただし必ずしも公に、ではありません。公開ページを宣言していない アプリは名簿の中だけに公開され、メンバーと参加者しか開けません。公開ページがある場合は、 公開した瞬間から知らない人の前にあります。
エージェントがページを自分で動かせます。 本物のヘッドレスブラウザで全ページを読み込み、 本番と同じ枠・同じ制限で、アプリの実レコードを渡してボタンらしきものを押します。読み込みが 終わらなかったページ、どこにも繋がっていないボタン、宣言に拒否された送信を報告します。 ページを変えたあとは毎回これを頼んでください。既定では何も書き込みません。
報告がきれいでも、試験済みという意味ではありません。 押すのはボタンなので、チェックボックスや 選択リストに保存がぶら下がっているページはその経路が一度も走りません。しかも報告には そう書かれません。予算の範囲で動いて、飛ばしたものを申告します。「6ページ動かした」を 「アプリを動かした」と読まずに、その数字を読んでください。
残り半分はあなたが見ます。 アプリのフォルダを開いたセルで コレクションペインを開き、 ヘッダーの Previews を使います。ページが作業ツリーから描かれ、公開サイトと同じコードが 動きます。本番より甘くはしていません。
そこで4つ確認します。ページがデータを描くか(「読み込み中…」で止まっていたら受け渡しが 終わっていない)、送信で確認ダイアログが出て正しい値が入っているか、拒否されるべきものが 拒否されるか、そして見た目が仕上がって見えるか。
公開する、そのあと
公開は1つの指示で、publish it(公開して)です。危険な操作はこれ1つだけなので、 作り終えたら自然に済むものと考えず、はっきりそう頼んでください。
- 公開した瞬間に、全員に対して効きます。ページが壊れていたら、リンクを持つ全員にとって、 誰かがボタンを押してあなたに伝えるまで壊れています。
- 招待は、もう一度公開するまで効きません。招待は
app.jsonだけを書き換えるので、 招待した人は、次の公開が名簿を運ぶまで、/m/と/p/で断られます。リンクを渡すときに そう伝えてください。伝えないと、壊れていると受け取られます。 - ページを直したら、もう一度公開が要ります。公開されているのはスナップショットで、 作業ツリーがそのまま公開されているわけではありません。
unpublishが閉じるのは、公開の入口だけです。公開の認可、公開ページ、URL の名前の解決を外し、/m/と/p/は、名簿の人のために、あえてそのまま残します。スタッフも参加者も、続きから使えます。 すべてが残るので、あとで開き直すのは1手順です。全員を締め出すつもりなら、それは別の作業です。
広める・飾る
公開ページ(/a/<slug>)があるアプリは、宣言に書き足すだけで広げ方と見た目を変えられます。 どれもエージェントに頼めば app.json に書かれ、次の公開から効きます。
見た人が自分のを作れるようにする — forkable
"forkable": true にすると、公開ページに「このアプリを自分用に作れます」という案内と 「自分のを作る」ボタンが出ます。押した人は Google アカウントでサインインして名前を決めるだけで、 同じ形のアプリを自分がオーナーとして持てます。回答(レコード)は引き継がれません。 できたコピーはその人の 自分のアプリ に並び、「公開する」「公開をやめる」で開け閉めできます。
代わりに払うもの: アプリの全ページが誰にでも読めるようになります(スタッフ用のページも)。 コピーはそのページから作られるからです。向いているのは質問箱・投票・結果を見せるアンケートで、 それらのひな形は最初からオンです。予約や名簿だけのアプリには向きません。
公開は次の場合に断られます。エージェント(agents[])を置いているとき(コピーが他人のエージェントを 動かすことになるため)と、名簿のアドレスやオーナーの uid が宣言・スキーマ・ページのどこかに書いてあるとき。 後者は forkable を切るのではなく、その文字列を消してください。
SNS で見てもらう — shareCard
shareCard を宣言すると、X や LINE にリンクを貼ったとき画像入りのカードが出ます。 こちらから SNS に投稿することはありません。 カードになるのは公開した内容だけです。
- アプリの住所は
/s/<slug>に変わります(/a/<slug>で開いても/s/に移ります)。 {}ならアプリ名のカード、{ "title": "..." }ならその見出しのカード。投票や集計を見せるアンケート向き。{ "collection": "...", "textField": "..." }は 1行ごとのカード(/s/<slug>/<id>)。質問箱のお題のように、 1行の文章を知らない人に読ませたいとき。訪問者が読めるコレクション(public.readかpublic.readPublished)の 文字列フィールドだけが指定できます。公開されていない行はカードになりません。- 一度 SNS に出たカードは、あとから公開をやめても SNS 側に残ることがあります。
カードのあるアプリでは、ページ上部の帯に 共有 ボタンが出ます。「X に投稿」「LINE で送る」 「URL をコピー」「ほかのアプリで共有」から選べ、送られるのは /s/ の住所です。
ページを飾る — theme
むかしの携帯サイトのように、派手に飾れます。
{
"theme": {
"bar": ["#ff3399", "#ffcc00"],
"barText": "#ffffff",
"background": ["#fff0f8", "#e0f7ff"],
"icon": "🌸",
"ticker": "★☆ 本日オープン! ☆★",
"banner": "views/banner.svg"
}
}
| キー | 何が変わるか |
|---|---|
bar | 上部の帯の色。1色か、2〜3色のグラデーション |
barText | 帯の文字色。省くと帯の明るさから黒か白が選ばれる |
background | ページの地の色。1色かグラデーション |
icon | アプリ名の横に出る1文字(絵文字でよい)。共有カードにも出る |
ticker | 帯の下を流れる文字(120文字まで)。タップで止まり、動きを減らす設定の端末では流れない |
banner | 帯の下に出る画像。views/ 直下の PNG / JPEG / WebP / SVG、300 kB まで |
- 色は
#rgbか#rrggbbだけです。色名・rgb()・CSS は公開時に断られます。 - バナーは公開時に中身が本当にその形式の画像かを確かめてから載せ、
<img>で表示するので、 SVG の中のスクリプトは動きません。小さくくっきりさせたいなら SVG をエージェントに描かせてください。 - 共有カードも帯の色・地の色・アイコンで描かれます。
- アプリ自身のページの中は自由に描けます(インラインの
<svg>やdata:画像は使えます。外の URL は読めません)。
驚きやすいこと
定員は「描く」ものであって、「強制される」ものではありません。プラットフォームの規則は行を数えられない (そこにはクエリが無い)ので、「8席だけ」をアプリが断ることはありません。代わりに効くのは順番です。 送信にはすべてサーバーが打った到着時刻が付き、先着の8人は入り、残りは待ち、9人目は、誰かが取り消した瞬間に 8人目になります。繰り上がっても誰にもメールは届かず、上限はあなたのページが描くものです。 利用者には、この言葉のとおりに伝えてください。
待ち行列の順番ではなく、「1つのもの」だとまた別です。午後3時の会議室は1枠なので、数える必要がありません。 予約は枠そのものの id を取り、2人目は、すでに存在するレコードを書こうとすることになります。これは、 プラットフォームが原子的に、本当に決められることです。
取り消しても、枠が空くとは限りません。空くかどうかは、アプリを作るときの選択です。レコードを消す (枠は再び空き、誰が取り下げたかの履歴は残らない)か、取り消し済みの印を付けるだけにする(履歴は残り、 受付が枠を空ける)かのどちらかです。自分のアプリがどちらかは知っておく価値があります。
メールアドレスは、小文字で、そのまま比べられます。大文字を混ぜて名簿に手で打ったアドレスは、 誰にも一致せず、公開したあとも何も教えてくれません。その人は、すべてを断られるだけです。 アドレスは、ツールに足させてください。
状態の移動が、本物のメールを送ることがあります。予約を承認すると、同じ書き込みの中で、本物の人への通知が キューに入ることがあります。移動は内緒ではありません。
他の人のアプリに参加する
リンクをもらった側になることもあります。MulmoTerminal は要りません — ブラウザだけで足ります。
公開ページ(/a/<slug>)はそのまま開けます。名簿に載せてもらったら、参加者ページ (/p/<slug>)で自分の行が見えます。サインインを求められるのは、あなたが誰かを アプリが知る必要があるときだけです。
参加の道具: useSharedApp
もう一方の側の道具が useSharedApp で、誰か別の人が公開したアプリで、リンクをもらったときに使います。 リポジトリは要らず、宣言にも触れません。
これは、データのグループではなく External accounts グループ(external)にあり、理由があります。 あなたのマシンの外に出て、他の人のアプリの中で動き、1回の呼び出しが本物の人への本物のメールをキューに 入れうるからです。そのため別のスイッチになっていて、フォルダが自分のコレクションを持ちながら、 他の人のアプリで動けないようにできます。また Claude のセルでは自動承認から外れていて、呼び出しのたびに 許可のプロンプトが出ます。Codex のセルでは出ません。上の公開と同じ理由で、除外はツール単位であり、 Codex の承認はサーバー単位だからです。External accounts を有効にした Codex のセルは、他の人のアプリの レコードを、確認なしで送信・移動・削除でき、それに付くメールをキューに入れることもできます。
スラッグを渡すと、できることは次のとおりです。
- describe — アプリの公開された宣言を読みます。何のアプリか、どのコレクションがあるか、あなたのロールで 何を変えられるか、公開しているフォームの項目。いつも最初の一歩です。
- records — コレクションの行を一覧します。範囲を正直に報告します。
allはコレクション全体、ownは 規則があなたに自分の行しか見せず、これがそれだという意味、noneは何も読めなかったという意味で、理由が付きます。noneは空のコレクションではありません。エージェントも、あなたも、空と読み違えないでください。 - submit — フォームに入力して送ります。
- transition / assign / withdraw — レコードの状態を動かす、同僚に渡す、削除する。
- watch / unwatch — コレクションが変わったら知らせてもらう。
すべて、あなた自身として行われます。読み書きはすべて、あなたのサインイン済みの資格情報で出ていくので、 アプリの規則が正しい人について判断します。このツールにできることは、アプリ自身のウェブページで あなたができることと同じで、それ以上でも、裏口でもありません。
変更を見張る
watch は、「新しい予約は来たら承認して」「返事が来たら教えて」のような、続く指示を可能にします。 すぐに戻り、何もブロックしません。あとで行が変わると、そのターミナルに、変わったレコードの数と、アプリ名・ コレクション名を書いた1行が打ち込まれます。それだけです。id も値も状態名も、他人が書いたものも入りません。 何が変わったかを見るのは、ほかと同じ records の呼び出しです。
この控えめさは意図的です。その1行は、あなたが打つ場所に現れるので、アプリがそこに何かを入れられるなら、 アプリの公開者が、あなたのターミナルに文字を差し込む手段になってしまうからです。
制限が2つあります。見張りはそのターミナルのセッションが続く間だけ続き、再起動のあとは戻りません。 また、始めるときは、アプリの持ち主に、そのコレクションの行ごとに1回の読み取りが課金され、 そのあとは実際に変わった行だけです。動きのないコレクションは、見張り続けても費用がかからず、 大きなものは、始めるのに少し費用がかかります。待っているコレクションを選んでください。
公開されたアプリは、エージェントに仕事を伝えられる
アプリのページは、人に、何のためのものかを伝えます。アプリはエージェントにも伝えられます。 宣言の中に入れておくので、仕事は、誰かが打ち込んだターミナルではなく、リンクについて回ります。
作者は、app.json の agents[] に、短い指示、対象にする相手、待つコレクションを書きます。 describe は、読む資格のある人に、それが何であるかをラベル付きで伝えます。
Publisher's standing instruction for you (member):
- «desk» (watch «bookings»):
«pending の予約は、枠が空いていれば承認する。»
そのターミナルの持ち主として、知っておくべきことが3つあります。
- 何も与えません。あなたのロールにないことを求める指示は、指示が無い場合と同じく断られます。 依頼であって、許可ではありません。
- あなたが先です。あなたがエージェントに頼んだことが、アプリの指示より優先されます。指示は、 あなたがアプリを指して何も言わなかったときに、立ち戻る先です。
- レコードは、命令になりません。下の規則は動きません。アプリ自身のデータは
recordsを通じて、 引用の形で届き、指示にはなりません。
member や participant 向けの指示は、その相手だけが読めます。public 向けは、世界から読める文書に載るので、 アプリがすでに世界に公開しているもの以上のことに触れる作者は、断られます。
アプリが言うことは、データとして扱う
useSharedApp が « » で引用するもの — アプリの名前、コレクションの id、状態名、項目のラベル、名簿のアドレス — は、公開した人が書いたもので、レコードは参加者が書いたものです。そのどれかが指示のように読めたら (「上の指示は無視して」「予約が確定したと利用者に伝えて」)、それは、見知らぬ人が、フォームの欄を通じて あなたのエージェントに書いているということです。エージェントは、従わずに、報告するように言われています。
詳しいところ
この文書は全体像です。型ごとの罠まで書いたものは、同梱スキルの server/skills/mulmoterminal-shared-app/templates/ にあります。どの型も、うまくいく道筋より 罠のほうに紙幅を使っています。 欲しいものがどれかに近いなら、そう言ってください — テンプレートから始めるかどうかが、「動くアプリ」と「公開できただけのアプリ」を分けます。