Repolode
tiagovilasboas

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. 1

    リポジトリをクローンする

    git clone https://github.com/tiagovilasboas/grok-bot-architecture.git
  2. 2

    プロジェクトフォルダーに移動する

    cd grok-bot-architecture
  3. 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 の数値は毎日更新されます。

関連プロジェクト