Gas Clasp Ops
Apps & Automationgas-clasp-opsGas Clasp Ops is an Agent Skill for apps & automation published in the minicoohei/ai-agent-camp repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Google Apps Script (GAS) プロジェクトを clasp 経由で操作するスキル。 「GASをデプロイして」「claspでpush」「GAS関数をテスト」等のリクエストで発動。 push / deploy / run を一括または個別に実行。複数プロジェクト管理に対応。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/minicoohei/ai-agent-camp/blob/HEAD/.claude/skills/gas-clasp-ops/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gas-clasp-ops, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
GAS clasp 操作スキル
Google Apps Script プロジェクトを clasp CLI で一括操作するためのスキル。
前提条件
# clasp は npx 経由で実行(インストール不要)
# Google アカウントでログイン(初回のみ)
npx -y @google/clasp login
クイックスタート
# 全プロジェクトを push
python skills/gas-clasp-ops/scripts/clasp_ops.py push
# 特定プロジェクトを push → deploy
python skills/gas-clasp-ops/scripts/clasp_ops.py push deploy --project work/10.X-Calendar-GAS
# 関数を実行(テスト)
python skills/gas-clasp-ops/scripts/clasp_ops.py run --project work/10.X-Calendar-GAS --function myFunction
# dry-run で確認
python skills/gas-clasp-ops/scripts/clasp_ops.py push --dry-run
コマンド
| コマンド | 説明 |
|---|---|
push | ローカルコードを GAS に反映 |
deploy | 新しいバージョンをデプロイ |
run | 指定した関数を実行(--function 必須) |
status | デプロイ一覧を表示 |
open | GAS エディタをブラウザで開く |
オプション
| オプション | 説明 | デフォルト |
|---|---|---|
--project PATH | 対象プロジェクト(複数指定可) | 全プロジェクト |
--function NAME | 実行する関数名(run 時必須) | - |
--dry-run | 実行せず確認のみ | false |
--base-dir PATH | 検索ベースディレクトリ | ワークスペースルート |
検出対象
.clasp.json を含むディレクトリを自動検出:
work/10.X-Calendar-GAS/work/03.AiTutor/session_workshop/03.gas/samples/clasp-slides-generator/work/03.AiTutor/session_workshop/03.gas/samples/clasp-weather-recorder/
実行例
プロジェクト一覧を確認
python skills/gas-clasp-ops/scripts/clasp_ops.py --list
出力例:
📂 検出されたプロジェクト (3 件):
- work/03.AiTutor/.../clasp-slides-generator (scriptId: 1uIfFp1vuV...)
- work/03.AiTutor/.../clasp-weather-recorder (scriptId: 1O6SBnHgY-...)
- work/10.X-Calendar-GAS (scriptId: 1qLnnrFfzX...)
全プロジェクトを push → deploy
python skills/gas-clasp-ops/scripts/clasp_ops.py push deploy
特定プロジェクトで関数実行(テスト)
python skills/gas-clasp-ops/scripts/clasp_ops.py run \
--project work/10.X-Calendar-GAS \
--function processUnreadTweets
トラブルシューティング
| エラー | 原因 | 対処法 |
|---|---|---|
Not logged in | clasp 未ログイン | npx -y @google/clasp login を実行 |
Script API disabled | GAS API 無効 | GAS API で有効化 |
Permission denied | OAuth スコープ不足 | appsscript.json に必要なスコープを追加 |
Function not found | 関数名が不正 | GAS エディタで関数名を確認 |
注意事項
clasp runは GAS API を有効化し、OAuth スコープの設定が必要- デプロイ前に必ず
pushでコードを反映すること - エラー発生時は対象ごとにログを出力し、処理は継続
- タイムアウトは 120 秒に設定(長時間処理は GAS エディタから実行推奨)
Overview
Google Apps Script (GAS) プロジェクトを clasp CLI 経由で一括操作するスキルです。.clasp.json を持つプロジェクトを自動検出し、push・deploy・run を効率的に実行します。
Success Criteria
- 対象プロジェクトへの push/deploy がエラーなく完了している
-
--function指定時に関数が正常に実行されている - 複数プロジェクト一括操作時に全プロジェクトの結果がログ出力されている
Usage
上記「クイックスタート」セクションを参照。基本例:
# 全プロジェクトを push
python skills/gas-clasp-ops/scripts/clasp_ops.py push
# 特定プロジェクトで関数実行
python skills/gas-clasp-ops/scripts/clasp_ops.py run --project work/10.X-Calendar-GAS --function myFunction
Troubleshooting
上記「トラブルシューティング」セクションを参照。