---
name: gas-clasp-ops
description: |
  Google Apps Script (GAS) プロジェクトを clasp 経由で操作するスキル。
  push（コード反映）、deploy（デプロイ）、run（関数実行/テスト）を一括または個別に実行。
  .clasp.json を持つプロジェクトを自動検出し、複数プロジェクトの管理を効率化する。
  
  トリガー: GAS, clasp, デプロイ, push, テスト実行, Apps Script, スクリプト反映
  使用例: 「GASをデプロイして」「claspでpush」「GAS関数をテスト」「全プロジェクトをpush」
---

# GAS clasp 操作スキル

Google Apps Script プロジェクトを clasp CLI で一括操作するためのスキル。

## 前提条件

```bash
# clasp のインストール（未インストールの場合）
npm install -g @google/clasp

# Google アカウントでログイン（初回のみ）
clasp login
```

## クイックスタート

```bash
# 全プロジェクトを push
python .claude/skills/gas-clasp-ops/scripts/clasp_ops.py push

# 特定プロジェクトを push → deploy
python .claude/skills/gas-clasp-ops/scripts/clasp_ops.py push deploy --project work/10.X-Calendar-GAS

# 関数を実行（テスト）
python .claude/skills/gas-clasp-ops/scripts/clasp_ops.py run --project work/10.X-Calendar-GAS --function myFunction

# dry-run で確認
python .claude/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/`

## 実行例

### プロジェクト一覧を確認

```bash
python .claude/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

```bash
python .claude/skills/gas-clasp-ops/scripts/clasp_ops.py push deploy
```

### 特定プロジェクトで関数実行（テスト）

```bash
python .claude/skills/gas-clasp-ops/scripts/clasp_ops.py run \
  --project work/10.X-Calendar-GAS \
  --function processUnreadTweets
```

## トラブルシューティング

| エラー | 原因 | 対処法 |
|--------|------|--------|
| `Not logged in` | clasp 未ログイン | `clasp login` を実行 |
| `Script API disabled` | GAS API 無効 | [GAS API](https://script.google.com/home/usersettings) で有効化 |
| `Permission denied` | OAuth スコープ不足 | `appsscript.json` に必要なスコープを追加 |
| `Function not found` | 関数名が不正 | GAS エディタで関数名を確認 |

## 注意事項

- `clasp run` は GAS API を有効化し、OAuth スコープの設定が必要
- デプロイ前に必ず `push` でコードを反映すること
- エラー発生時は対象ごとにログを出力し、処理は継続
- タイムアウトは 120 秒に設定（長時間処理は GAS エディタから実行推奨）