--- name: gas-project-setup description: 新規 Google Apps Script(GAS) プロジェクトの立ち上げ標準手順（clasp + コマンドキュー全部入り、人間の手作業は setupOnce ▶実行 1クリックのみ）。「GAS 作って」「スプレッドシートに自動化を仕込んで」「Apps Script 新規」「シートにスクリプトをバインド」など新しい GAS プロジェクトを始める依頼が来たら必ずこの手順を使う。既存 GAS の修正では不要（GAS 開発ルールが適用される）。 --- # GAS プロジェクト立ち上げ標準シーケンスゴール: **人間の手作業 = `setupOnce` の ▶実行 1クリックだけ**。retrofit 禁止 — キューは最初の push に含める。前提: Workspace ポリシーで `clasp run-function` や ANYONE_ANONYMOUS Web App が封じられている環境でも、AI 側から GAS を継続実行できるようにするのが目的。手作業コピペ運用を無くす。 ## 1. ローカル準備 ``` mkdir -gas && cd -gas clasp create --type sheets --title "<名前>" # 既存シートにバインドするなら --parentId ``` `.clasp.json` を必ずリポジトリに残す（clasp 統一ルール）。 ## 2. 初回 push に含める4点セット（省略禁止） 1. `Setup.gs` — `setupOnce()` 1つだけ。プロジェクト固有初期化（列追加・初回同期など「今すぐ走らせたい処理」も全部ここに畳む）+ `installCommandQueue()` 呼び出し 2. `_COMMANDS_()` ホワイトリスト（関数名→関数の明示 map。eval/動的呼び出し禁止） 3. `installCommandQueue()` / `processCommandQueue()` — `-cmds` フォルダ、Script Property `CMD_FOLDER_ID`、1分トリガー。processCommandQueue は **LockService.tryLock(0) + payload 読込直後 setTrashed** で並走防止 4. `appsscript.json` — `oauthScopes`: `spreadsheets`, `drive`, `script.scriptapp`（+必要なら `script.external_request`）、`executionApi.access: "MYSELF"` コマンドキューの実装要点: `cmd_*.json`（`{"command":"...","args":[...]}`）をキューフォルダに置く → 1分トリガーの `processCommandQueue()` がホワイトリスト関数のみ実行 → `result_.txt` に書き戻し → cmd は setTrashed。並走二重実行は LockService.tryLock(0) + 即 setTrashed で防ぐ。機密値は Script Properties から読み、コマンド JSON には入れない。 ## 3. 人間への依頼（1回だけ・4要素形式で） - 直URL: `https://script.google.com/a//d//edit`（Workspace 管理ドメインなら `/a/<ドメイン>/` を挟むとアカウント切替不要。個人 Google アカウントなら素の URL） - 対象 `.gs` ファイル（Setup.gs）を**先に開いてもらう**（関数プルダウンは開いているファイルの関数しか出ない） - 選ぶ関数名: `setupOnce` → ▶実行 → OAuth「許可」 - 完了判定の見え方: 実行ログに `command queue installed` 等 ## 4. 以降の実行（AI 完結） Drive API/コネクタで `cmd_.json` を作成 → 1分待ち → `result_*.txt` を読む。動作検証は書き込み後の read-back まで実施（変更後の2段検証手順に従う）。 ## 5. 機密値 API キー等は Script Properties へ。コマンド JSON に含めない。他システムからの機密値の横断自動注入はセキュリティ機構に止められることがあるため、その場合は手動経路へ切り替える。 ---