app-starter

app-starter スキル

React アーティファクトに manifest（app） を付けると、権限を申請して動く「アプリ」になる。 このスキルは同梱の最小アプリ（通知の一覧と、テスト通知の送信）を生成する雛形で、生成物は そのまま自分のアプリへ書き換えて使う。

アプリの性質（先に知っておくこと）

• manifest だけでは何も動かない。 AI が書いた manifest は信頼されない。ユーザーがアーティファクトウィンドウの起動画面で起動し、承認ダイアログで許可して初めて権限が有効になる。承認の前に、あなたが API を呼べるようにする手段は無い。
• 宣言したものだけが使える。 manifest に無い権限（ツール・越境先・メモリー）は、承認済みでも常に拒否される。
• 通常のビューアでは動かない。 app 付きのアーティファクトは起動画面を出す。実行は承認後の常駐ウィンドウの中（sandbox iframe）。Web ビューアでは起動できない。
• 今の版で書ける権限は mcp（tools と targets）、memory（maxBytes 必須）、fs、db（下記）、aiTerminal（agents と maxConcurrent 必須）、network（allow に URL プレフィックス。下記）、subWindow（専用サブウィンドウ。下記）、audio（マイクの音声入力。下記）、media（動画・音声の再生。下記）だけ。wasm は未対応で、書くとエラーになる。
• コード（content / modules）を更新しても再承認は要らず、起動中なら承認を保ったまま iframe がリロードされる（フルリロード。メモリー以外の JS の状態は失われる）。権限（manifest の permissions）を変えたときだけ、起動中なら直ちに再承認のダイアログが出る。承認までは旧権限のまま動き（リロードもされない）、新しい権限が要る呼び出しは拒否される。承認でリロード、拒否で停止。

manifest

<SKILL_DIR>/app.json が雛形。

{
  "name": "表示名",
  "description": "説明",
  "version": "1.0.0",
  "permissions": {
    "mcp": {
      "tools": ["oretachi_list_worktree_notifications", "notify_worktree"],
      "targets": []
    },
    "memory": { "maxBytes": 65536 },
    "fs": {
      "read": ["worktree://docs/", "artifact://"],
      "write": ["worktree://out/", "artifact://data/"]
    }
  }
}

• mcp.tools: 呼びたいツールだけを書く。呼べるのは artifact ツールの説明にある一覧の部分集合。oretachi_write_terminal / oretachi_send_keys / oretachi_answer_prompt / oretachi_add_task は**ユーザーと同等の権限（任意コマンド実行）**として、承認ダイアログで強調される。本当に必要なときだけ宣言する。
• mcp.targets: 他のワークツリーへ届かせたいときだけ書く（省略 = 自ワークツリーのみ）。ワークツリー名 / ID、*、workgroup:<ID か名前>、repo:<リポジトリ名>。ワイルドカードは最も強い警告になる（今後作られるワークツリーも含み、メインのクローンの端末にも届く）。名前で書いたワークツリーは承認時に ID へ固定される。越境には、これに加えて既存の購読（oretachi_subscribe_worktree）も必要。
• memory.maxBytes: メモリーを使うなら必須（1〜1048576 バイト。書き込み後の JSON のバイト数で数える）。宣言が無い・0 以下・上限超過の manifest は拒否される。承認ダイアログに最大サイズが出る。上限を下げる変更も再承認になり、既存データが新しい上限を超えていても消えない（収まらない書き込みだけ拒否、読み取りは可）。