Google Apps Script Git 管理テンプレート

clasp（Google Apps Script CLI）を使って GAS プロジェクトをローカルで Git 管理するためのテンプレートリポジトリです。 Node.js と Yarn を使用して環境を構築します。

開発環境のセットアップ

本プロジェクトでは Node.js (v24) と Yarn を使用します。 以下の手順で開発環境を構築してください。

1. nodenv のインストール (Homebrew / Linuxbrew)

brew update
brew install nodenv

シェル設定ファイル（.bashrc, .zshrc 等）に以下を追記し、シェルを再起動または source してください：

eval "$(nodenv init -)"

2. Node.js (v24.14.0) のインストール

nodenv install 24.14.0
nodenv local 24.14.0

3. Yarn のインストール (npm 経由)

npm install -g yarn

4. 依存関係のインストール (@google/clasp, eslint, prettier 等)

yarn install

Google Apps Script のセットアップ

1. Google アカウントでログイン

yarn login

ブラウザが開き、Google アカウントでの認証を求められます。

2. GAS プロジェクトの作成または紐付け

新規作成の場合:

yarn create --title "プロジェクト名" --type standalone

既存プロジェクトの場合:

yarn clone <SCRIPT_ID>

実行すると、.clasp.json が作成されます。

3. コードをプッシュ

yarn push

開発ワークフロー

操作	コマンド
ローカル → GAS へ反映	yarn push
変更監視＆自動プッシュ	yarn push:watch
GAS → ローカルへ反映	yarn pull
ブラウザで開く	yarn open
静的解析 (Lint)	yarn lint
自動修正 (Fix)	yarn lint:fix
フォーマット	yarn format

Agent Skills

このプロジェクトには、AI Agent で使用できる便利なスキルが含まれています。

• gas-init: 環境構築・初期化ガイド
• gas-quality: コード品質チェック (Lint/Test) ガイド
• gas-release: バージョン作成・デプロイガイド

使用例:

"プロジェクトの初期化を手伝って" -> gas-init が起動 "コードの品質をチェックして" -> gas-quality が起動

リポジトリ構成

.
├── appsscript.json       # GAS プロジェクト設定
├── package.json          # npm スクリプトと依存関係
├── .clasp.json           # clasp 設定 (scriptId を含む / .gitignore 推奨)
├── eslint.config.mjs     # ESLint 設定
├── JapaneseHoliday.gs    # サンプル: 日本の祝日取得
├── .github/skills/       # Agent Skills
└── README.md             # このファイル

サンプルスクリプトの詳細は各ファイルのコメントを参照してください。