poke-assistant

Poke アシスタント

概要

受信 Webhook API を使って、Poke アシスタントにメッセージを送信します。Poke は、iMessage、SMS、WhatsApp に対応した会話型 AI アシスタントです。このスキルを使うと、Claude から Poke に通知、アラート、更新情報を直接送信できます。

使用する場面

• 時間のかかるタスクが完了したときにユーザーへ通知する
• 対応が必要なエラーアラートや警告を送信する
• ビルド、テスト、デプロイの進捗状況を知らせる
• リマインダーや概要を送信する
• 重要なイベント（CI の失敗、セキュリティ上の問題など）を通知する

前提条件

• poke.com の Poke アカウント
• POKE_API_KEY 環境変数

インストール

API キーを取得する

1. poke.com/settings にアクセスします
2. Advanced セクションに移動します
3. API キーを生成するか、コピーします
4. シェルプロファイルに追加します：

echo 'export POKE_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc

クイックスタート

簡単なメッセージを送信します：

python scripts/send_message.py -m "Hello from Claude Code!"

コンテンツを Poke にパイプします：

echo "Build completed successfully" | python scripts/send_message.py

コマンドリファレンス

python scripts/send_message.py [options]

Options:
  -m, --message TEXT    Message to send to Poke
  -v, --verbose         Show detailed output
  -h, --help            Show help message

Input:
  Message can be provided via -m flag or piped to stdin.
  If both are provided, -m takes precedence.

Exit codes:
  0  Success
  1  Missing message or API key
  2  API error (authentication, rate limit, etc.)
  3  Network error

使用例

タスク完了のアラート

python scripts/send_message.py -m "Build completed: 42 tests passed, 0 failed"

エラー通知

python scripts/send_message.py -m "ERROR: Deployment to production failed. Check logs."

コマンド出力をパイプする

git log --oneline -5 | python scripts/send_message.py -m "Recent commits:
$(cat)"

詳細を含むステータス更新

python scripts/send_message.py -m "Code review complete:
- 3 files changed
- 2 suggestions made
- Ready for merge"

テスト失敗時のアラート

npm test || python scripts/send_message.py -m "Tests failed! Check the output."

ワークフローとの統合

時間のかかるタスクの完了後に通知する

時間のかかるタスクを実行するときは、完了時に通知します：

# Run build and notify
npm run build && python scripts/send_message.py -m "Build finished successfully" \
  || python scripts/send_message.py -m "Build failed!"

日次サマリー

作業内容の概要を送信します：

python scripts/send_message.py -m "Daily summary:
- Implemented user auth
- Fixed 3 bugs
- Updated documentation"

ベストプラクティス

通知を送信する場面

• 2〜3 分以上かかるタスク
• ユーザーの対応が必要なエラー
• 重要なマイルストーン（デプロイ、リリース）
• セキュリティ関連のアラート

送信しない場面

• すぐに完了する通常の操作
• 細かなステップごとの通知（通知疲れを避けます）
• 機密情報（認証情報、トークン）

メッセージのガイドライン

• 簡潔ながらも情報が伝わるメッセージにします
• 対応に役立つ情報（何が起きたか、何をすべきか）を含めます
• 複数行のメッセージでは、分かりやすい書式を使います

トラブルシューティング

「POKE_API_KEY environment variable not set」

API キーを設定します：

export POKE_API_KEY="your-api-key"

または、永続化するには ~/.zshrc に追加します。

「API returned 401: Unauthorized」

API キーが無効か、有効期限切れです。poke.com/settings で新しいキーを生成してください。

「API returned 429: Too Many Requests」

レート制限が適用されています。次のメッセージを送信する前に、数分待ってください。

「Network error: Connection refused」

インターネット接続を確認してください。Poke API へのアクセスにはネットワーク接続が必要です。

Poke にメッセージが表示されない

• API キーが正しいことを確認します
• Poke の設定でメッセージングが有効になっていることを確認します
• メッセージングチャンネル（iMessage／SMS／WhatsApp）が設定されていることを確認します