mcpField
G
grok-bot

grok-bot

github.com/adamanzエージェントワークフロー1564 回インストール10 週間前に更新
リポジトリ

grok-bot について

ローカルの Python CLI で Grok Bot のチームメイトを管理するスキルです。状態確認、一覧表示、メッセージ送信、依頼に応じたボット作成に対応し、安全な操作方法も示します。

主な機能

  1. 01ボットの状態確認と一覧表示
  2. 02返信を待つチャットと非同期送信
  3. 03役割を定めたボット作成
  4. 04名前または ID によるボット指定
  5. 05秘密情報と権限に関する安全指針

活用シーン

  1. 01利用可能な Grok Bot チームメイトの確認
  2. 02既存ボットから回答を得る
  3. 03後で確認するタスクの依頼
  4. 04特定の役割を持つチームメイトの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/adamanz/grok-bot-skill --skill grok-bot

インストール後、Claude Code で/grok-botを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

examples.md
SECURITY.md
CHANGELOG.md
LICENSE
package.json
README.md
.gitignore
AGENTS.md
.claude-plugin/
marketplace.json
scripts/
grokbot.py

詳細

Grok Bot

ローカル CLI を使って、既存の Grok Bot のチームメイトと会話したり、新しいチームメイトを作成したりできます。 Grok Bot のデスクトップ UI は操作せず、ゲートウェイを直接呼び出さないでください。

ワークフロー

  1. status を実行し、続けて list を実行します。
  2. chat（返信を待ちます）または send（返信を待たずに送信します）で、既存のボットにメッセージを送ります。
  3. ユーザーが新しいチームメイトを希望した場合に限り、create で新しいボットを作成します。
  4. ボットごとに、目的を絞った作業を 1 つ割り当てるようにしてください。継続的なルールは --description に記載します。最初のタスクは、下書きの作成のみとします。

CLI は、このファイルと同じディレクトリにある scripts/grokbot.py です。このパスはインストール済みのスキルディレクトリを起点に解決してください（多くの場合、~/.cursor/skills/grok-bot/scripts/grokbot.py です）。

SCRIPT="$(dirname "$0")/scripts/grokbot.py"
# or, after a global Cursor install:
SCRIPT="$HOME/.cursor/skills/grok-bot/scripts/grokbot.py"

python3 "$SCRIPT" status
python3 "$SCRIPT" list
python3 "$SCRIPT" chat --name Reed --prompt "What are you waiting on from me?"
python3 "$SCRIPT" create --name Reed --title "Chief of staff" --description "Draft-only daily brief. Never send messages."
python3 "$SCRIPT" transcript --name Reed --limit 20

出力は JSON です。ユーザー向けに要約してください。トークン、ゲートウェイ URL、生のキーチェーン情報をチャットに貼り付けないでください。

作成時のルール

新しいボットの作成には、次の情報が必要です。

  • --name — 短く、一意の名前
  • --title — 「汎用ヘルパー」ではなく、作業を 1 つ指定します
  • --description — 期待する成果、情報源、承認なしに行ってはならないこと

ユーザーから依頼されない限り、同じ名前のボットを 2 つ作成しないでください。--force を指定しない限り、CLI は重複を拒否します。

作成後、ユーザーが空のチームメイトだけを希望した場合を除き、chat で具体的な最初のタスクを 1 つ送ります。

チャット時のルール

  • 名前が一意の場合は --name でボットを指定し、名前が重複する場合は --id を使います。
  • ユーザーがこの会話での回答を期待している場合は、chat を使います。
  • ユーザーが Grok Bot アプリで進捗を確認する長時間の作業には、send を使います。
  • stillRunning が true の場合は、その旨を伝え、再度状況を確認するか尋ねてください。返信を捏造しないでください。
  • パスワード、API キー、2FA コードを送信しないでください。Grok Bot アプリで Agent Computer の操作をユーザーに引き継ぐよう伝えてください。
  • ユーザーから明示的に依頼されない限り、ローカルコンピューターへのアクセスを承認しないでください。

安全性

  • CLI は Keychain と sand-secrets.json から Grok Bot のセッションを復号します。これらはシークレットを扱うブローカーとして扱ってください。トークンを表示したり、ログに記録したりしないでください。
  • ユーザーのすべてのボットが、1 台のクラウドコンピューターを共有します。ボット同士をセキュリティ境界として扱わないでください。
  • これは Cursor Cloud Agents API（api.cursor.com/v1/agents）ではありません。ユーザーが Grok Bot を依頼した場合、コーディング用クラウドエージェントを作成しないでください。

トラブルシューティング

症状対応方法
サインインしていない／トークンの形式が想定と異なるGrok Bot を開き、Cursor でサインインするようユーザーに依頼します
キーチェーンの読み取りに失敗したログインキーチェーンのロックを解除して、再試行するよう伝えます
アクセスが許可されていない対象プラン：SuperGrok Heavy、Cursor Ultra、Cursor Teams Premium
コンピューターの起動が続いているコンピューターが起動するまで待ち、status を再実行します
その名前のボットが見つからないlist を実行し、名前を確認します

CLI にユーザーが必要とするコマンドがない場合は、scripts/grokbot.py --help を確認してください。チャット内で新しいゲートウェイルートを捏造しないでください。

コメント

Markdown 対応