複数のLLMエージェントを連携させる、セルフホスト型のTypeScriptエージェント実行環境。人による承認ゲートと、オフラインで検査できる実行ジャーナルを備えています。
tiagovilasboas/grok-bot-architecture
再利用可能なロールスキル、MCPコネクター、人間による承認ゲートを備えたAIエージェントチームの構成を示す、MITライセンスのリファレンスアーキテクチャです。
- スター
- 49
- フォーク
- 11
- 未解決の Issue
- 0
- 最終コミット
- 9 日前
これは何?
このリポジトリは、モデルやフレームワークに依存しない、AIエージェントチームの構成を示すリファレンスです。chief-of-staffエージェントが目標を範囲の明確なタスクに分解して割り当て、エンジニアリング、パブリッシング、セキュリティ、受信トレイのトリアージ、キャリア審査などを担う専門エージェントに振り分けます。各ロールは再利用可能なSKILL.mdのレシピとして定義され、無制限のアクセスではなく、ホスト側で強制されるツール権限のもとで動作します。
中核となる考え方は、人間をループに含めた承認フローです。権限を要する操作では、特定の操作とリビジョンに結び付いたリクエストが生成され、認証済みの判断を待ちます。タイムアウト時は実行せず、待機状態を維持します。型付きの引き継ぎレコードとMarkdownボードを使って、ロール間でタスクと証拠を共有します。また、JSONバリデーター、ボード用ツール、ローカルで完結する承認ライフサイクルのサンプルも含まれています。
このプロジェクトでは、セットアップ手順、承認ポリシーのガイダンス、ウォークスルーを通じて、このパターンをGrok Botに適用する方法も説明しています。Grok Bot製品のソースコードは含まれておらず、xAIとの提携関係もありません。
主な機能
- 01専門ロールのタスク範囲を定め、割り当て、レビューするchief-of-staffエージェント
- 02SKILL.mdのレシピとして定義された、再利用可能な9種類のロールスキル
- 03各判断を特定の操作リビジョンに結び付け、タイムアウト時には待機する承認ゲート
- 04状態と証拠を共有するための、型付き引き継ぎレコードとMarkdownボード
- 05外部依存のないJSONバリデーターと、ローカルで完結する承認ライフサイクルのサンプル
ユースケース
- メールやコードなど、それぞれ異なる領域を担当する永続的なAIアシスタントチームの設計
- エージェントがメッセージを送信したり、コードをマージしたり、外部システムを変更したりする前に、人間の承認を追加する
- 既存のエージェントホストにロールベースの権限と引き継ぎを適用する
- 本番コードを書く前に、エージェントシステムの信頼境界に関するパターンを学ぶ
クイックスタート
- 1
リポジトリをクローンする
git clone https://github.com/tiagovilasboas/grok-bot-architecture.git - 2
プロジェクトフォルダーに移動する
cd grok-bot-architecture - 3
ローカルの検証と承認ライフサイクルのチェックを実行する
bash scripts/check.sh
使う前に知っておきたいこと
- これは参照アーキテクチャとドキュメントのパターンであり、単体で動作するランタイムエージェントシステムではありません。
- Grok Bot のセットアップ手順は、ソースコードが含まれていない別製品の Grok Bot に依存します。
- バリデーターがチェックするのはファイル形式のみで、人間の承認者の認証や副作用の実行は行いません。
収録されている特集
トピック
よくある質問
- grok-bot-architecture とは?
- 再利用可能なロールスキル、MCPコネクター、人間による承認ゲートを備えたAIエージェントチームの構成を示す、MITライセンスのリファレンスアーキテクチャです。 このリポジトリは、モデルやフレームワークに依存しない、AIエージェントチームの構成を示すリファレンスです。chief-of-staffエージェントが目標を範囲の明確なタスクに分解して割り当て、エンジニアリング、パブリッシング、セキュリティ、受信トレイのトリアージ、キャリア審査などを担う専門エージェントに振り分けます。各ロールは再利用可能なSKILL.mdのレシピとして定義され、無制限のアクセスではなく、ホスト側で強制されるツール権限のもとで動作します。
- grok-bot-architecture は無料で使えますか?ライセンスは?
- grok-bot-architecture は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- grok-bot-architecture は今もメンテナンスされていますか?
- 活発にメンテナンス中。grok-bot-architecture の最終コミットは 2026年10月29日 です。
- grok-bot-architecture は何に使えますか?
- メールやコードなど、それぞれ異なる領域を担当する永続的なAIアシスタントチームの設計 エージェントがメッセージを送信したり、コードをマージしたり、外部システムを変更したりする前に、人間の承認を追加する 既存のエージェントホストにロールベースの権限と引き継ぎを適用する 本番コードを書く前に、エージェントシステムの信頼境界に関するパターンを学ぶ
- grok-bot-architecture のインストール方法は?
- リポジトリをクローンする: git clone https://github.com/tiagovilasboas/grok-bot-architecture.git プロジェクトフォルダーに移動する: cd grok-bot-architecture ローカルの検証と承認ライフサイクルのチェックを実行する: bash scripts/check.sh
- grok-bot-architecture はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/tiagovilasboas/grok-bot-architecture
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIエージェント向けのセルフホスト型メール受信箱。RESTおよびMCP API、SMTP、リスクのあるメールへの人間による承認、署名付きWebhookを備えています。
エージェント型システムや決定論的ワークフローの構築、実行、監視、制御を行うセルフホスト型ランタイム/ビジュアルプラットフォーム。
AIエージェントと人が、レビュー付きで構造化データやドキュメントなどを共有するオープンソースのワークスペース兼データベース。
永続化されたqueenエージェントが作業を計画し、workerエージェントを並列起動して、共有SQLiteトラッカーで結果を管理するオープンソースのランタイム。
ブラウザーWebUI、ターミナルクライアント、チャットアプリ連携、各種ツール、メモリ、MCPに対応した、Python製のセルフホスト型パーソナルAIエージェントフレームワーク。