google-spaces-updates

Google Spaces の更新

ステータス: 本番環境対応済み 最終更新日: 2026-01-09

Webhook 経由でチームの Google Chat Space に更新を投稿します。

---

クイックスタート

1. セットアップ（プロジェクトごとに初回のみ）

/google-spaces-updates setup を実行するか、.claude/settings.json を手動で作成します。

{
  "project": {
    "name": "my-project",
    "repo": "github.com/org/my-project"
  },
  "team": {
    "chat_webhook": "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN",
    "members": ["Deepinder", "Joshua", "Raquel"]
  }
}

2. 更新を投稿する

"Post deployment update to team"
"Tell the team about the new feature"
"Ask the team about the auth approach"

---

仕組み

ステップ 1：プロジェクト設定を確認する

現在のプロジェクトディレクトリに .claude/settings.json があるか確認します。

cat .claude/settings.json 2>/dev/null || echo "NOT_FOUND"

NOT_FOUND の場合は、ユーザーに次のように尋ねます。

「このプロジェクトでは Google Spaces が設定されていません。セットアップしますか？チームの Google Space の Webhook URL が必要です。」

次に、templates/settings-template.json のテンプレートを使用してファイルを作成します。

ステップ 2：更新の種類を決定する

コマンドまたはコンテキストに基づいて、更新の種類を決定します。

種類	使用する場面
deployment	本番環境／ステージング環境へのプッシュ、Vercel などへのデプロイ後
bugfix	バグ修正後。特にチームから報告されたバグの場合
feature	レビューや利用が可能な機能の実装完了後
question	作業が滞っている場合や、判断についてチームの意見が必要な場合
custom	その他の場合

ステップ 3：コンテキストを収集する

投稿に含める関連情報を収集します。

# Recent commits (for context)
git log --oneline -3 2>/dev/null

# Current branch
git branch --show-current 2>/dev/null

# Changed files (if recent changes)
git diff --name-only HEAD~1 2>/dev/null | head -10

また、会話のコンテキストも使用します。

• 直近で完了した作業
• プレビュー／本番環境の URL
• 関連するファイルパス
• 誰に知らせる必要があるか

ステップ 4：メッセージをフォーマットする

templates/ ディレクトリから適切なテンプレートを使用します。

Google Chat の主な書式ルール：

• 強調には *bold* を使用します（Markdown の太字ではありません）
• 補足テキストには _italic_ を使用します
• 改行は通常どおり機能します
• 簡潔でありながら、情報が十分に伝わるメッセージにします
• 関連する場合は、行動につながるリンクを含めます

ステップ 5：Webhook に投稿する

curl -X POST "WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"text": "MESSAGE_HERE"}'

次のように置き換えます。

• WEBHOOK_URL は .claude/settings.json の team.chat_webhook の値に置き換えます
• MESSAGE_HERE はフォーマット済みのメッセージに置き換えます（引用符は適切にエスケープします）

ステップ 6：ユーザーに確認する

投稿後、ユーザーに次のように伝えます。

「チームチャットに更新を投稿しました：[投稿内容の簡単な概要]」

---

メッセージテンプレート

デプロイ

🚀 *Deployed: [PROJECT_NAME]*

[WHAT_CHANGED - 1-2 sentences]

• Branch: `[BRANCH]`
• Commit: `[COMMIT_HASH]`
[• Preview: URL (if applicable)]
[• Production: URL (if applicable)]

_Posted by [USER] via Claude Code_

バグ修正

🐛 *Bug Fixed: [PROJECT_NAME]*

*Problem:* [What was broken]
*Solution:* [How it was fixed]
*Files:* [Key files changed]

[• Commit: `[COMMIT_HASH]`]

_Please verify if you reported this issue._

機能の完了

✨ *Feature Complete: [PROJECT_NAME]*

*[FEATURE_NAME]*

[DESCRIPTION - what it does, 1-2 sentences]

[• Demo: URL]
[• Files: key files]

_Ready for review/testing._

質問

❓ *Question: [PROJECT_NAME]*

[QUESTION - clear and specific]

*Context:*
[Relevant background - what you're working on, what you've tried]

*Options considered:*
1. [Option A]
2. [Option B]

_@[PERSON] - would appreciate your input_

カスタム

📢 *Update: [PROJECT_NAME]*

[MESSAGE]

_Posted by [USER] via Claude Code_

---

セットアップコマンド

ユーザーが /google-spaces-updates setup を実行した場合：

1. Google Spaces の Webhook URL を尋ねます
2. プロジェクト名を尋ねます（または package.json／リポジトリから検出します）
3. チームメンバーを尋ねます（任意）
4. テンプレートを使用して .claude/settings.json を作成します
5. まだ追加されていない場合は、.claude/ を .gitignore に追加します
6. セットアップが完了したことを確認します

---

積極的な提案

次の場合は更新の投稿を提案します。

• 重要な作業の後に、ユーザーが「完了」「終わった」「完成した」と伝えた場合
• git push で main/master/production にプッシュした後
• ユーザーがチームメンバーの名前を挙げた場合
• ユーザーの作業が滞っているようで、チームの意見が役立ちそうな場合

「この件についてチームに更新を投稿しますか？」と尋ねます。

---

使用しない場合

• 小規模なリファクタリング、誤字の修正
• レビューを受けられる状態ではない WIP コミット
• 内部のデバッグ／テスト
• ただノイズになるだけの内容

---

Webhook URL の取得方法

1. Google Chat を開きます
2. 該当する Space に移動します
3. Space 名 → アプリと統合 → Webhook をクリックします
4. Webhook を追加をクリックします
5. 名前を付けます（例：「Claude Code Updates」）
6. Webhook URL をコピーします

URL の形式：https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN

セキュリティ：Webhook URL は非公開にしてください。.claude/settings.json を .gitignore に追加します。