gas-debug

検証済みv1.0.0

GAS（Google Apps Script）のエラーをメッセージ・スタックトレースから分析し、修正→clasp push→clasp run の検証を最大3回自律ループするデバッグスキル。よくある GAS エラーの対策表つき。トリガー: 「GASのエラー直して」「GASをデバッグして」「gas-debug」。対象: clasp 連携済み GAS プロジェクトのエラー。NOT for: デプロイのみの実行（→ /gas-deploy）。

uezu-t1週間前更新skills/gas-debug

ZIPダウンロード

GAS (Google Apps Script) のエラーを自律的にデバッグ・修正します。

前提条件

Node.js がインストール済み
clasp（@google/clasp）がインストール済み・clasp login で認証済み（npm i -g @google/clasp）
対象ディレクトリが .clasp.json で GAS プロジェクトと連携済み（clasp clone 済み）
clasp run で関数実行する場合は、対象関数が実行可能な状態（デプロイ種別・スコープ許可）であること

clasp コマンドが PATH 上にない場合は、フルパス（例: ~/.nvm/versions/node/<version>/bin/clasp）に読み替えて実行する。

入力

$ARGUMENTS

エラーメッセージ、スタックトレース、または「実行して確認して」等の指示。

ワークフロー

Phase 1: エラー分析

エラーメッセージとスタックトレースから原因を特定する。

よくある GAS エラーと対策：

エラー	原因	対策
`Cannot call SpreadsheetApp.getUi() from this context`	トリガー実行からUI操作	onOpen 等のUI関数に分離
`Invalid argument: id`	スプレッドシートIDが不正	PropertiesService から取得
`models/gemini-xxx is not found`	Gemini モデル名が古い	最新モデル名に更新
`blob のサイズが大きすぎます`	画像サイズ超過	リサイズ処理を追加
`Exceeded maximum execution time`	6分制限超過	バッチ処理に分割
`You do not have permission`	OAuth スコープ不足	appsscript.json にスコープ追加

Phase 2: 修正 & デプロイ

コードを修正
clasp push で反映
引数に関数名があれば clasp run <function> で実行

clasp push
clasp run <functionName>

Phase 3: 結果確認

実行結果を確認
エラーが再発した場合は Phase 1 に戻る（最大3回）
3回失敗したらユーザーに報告して相談

Phase 4: 完了報告

✅ GAS デバッグ完了:
  エラー: <original error>
  原因: <root cause>
  修正: <what was fixed>
  実行結果: <success/failure>