mcpField
A
Ark Analysis

Ark Analysis

github.com/mckinsey開発4320 回インストール今日更新
リポジトリ

Ark Analysis について

Ark のアーキテクチャ、実装、リソース定義を調べる開発者向けのスキルです。リポジトリのクローン方法と、コントローラー、CRD、A2A 実装の場所を示します。

主な機能

  1. 01Ark リポジトリのクローンを案内
  2. 02コードベースの構成を説明
  3. 03コントローラーと CRD の検索方法
  4. 04A2A コードの検索方法
  5. 05コード分析の手順

活用シーン

  1. 01Ark の機能の実装を理解
  2. 02コントローラーや CRD 定義を確認
  3. 03A2A 統合コードを検索
  4. 04特定機能のコードを分析

インストール

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

$npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-analysis

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

詳細

Ark の分析

このスキルは、リポジトリをクローンして内容を調べることで、Ark のコードベースを分析するのに役立ちます。

このスキルを使う場面

次のような場合にこのスキルを使ってください。

  • ユーザーが「Ark では X はどのように動作しますか？」と尋ねたとき
  • ユーザーが Ark のアーキテクチャや実装を理解したいとき
  • Ark のソースコード、CRD、コントローラーを調べる必要があるとき
  • ユーザーが Ark リポジトリの分析について言及したとき

クイックスタート

Ark リポジトリを一時的な場所にクローンします。

git clone [email protected]:mckinsey/agents-at-scale-ark.git /tmp/ark-analysis
cd /tmp/ark-analysis

コードベースの構成

Ark リポジトリは次のように構成されています。

  • ark/ - Kubernetes オペレーターとデフォルトの実行エンジン（Go）

    • コントローラーは A2A プロトコルを介してクエリを実行エンジンにディスパッチします
    • CRD：Agent、Model、Query、Team、MCPServer、ExecutionEngine、A2AServer
    • executors/completions/ - 組み込みのデフォルト実行エンジン

  • lib/ark-sdk/ - Python SDK（生成コード＋オーバーレイ）

    • プラグイン可能な実行エンジンのインターフェースとしての BaseExecutor ABC と ExecutorApp

  • services/ - コンポーネントサービス

    • ark-api/ - REST API ゲートウェイ（Python/FastAPI）
    • ark-broker/ - メモリ内イベントバス（Node.js/Express）
    • ark-dashboard/ - Web UI（Next.js/React）

  • samples/ - YAML 設定の例

  • docs/ - ドキュメントサイト（Next.js/MDX）

よくある分析タスク

コントローラーを探す
ls ark/internal/controller/
grep -r "Reconcile" ark/internal/controller/
CRD を探す
ls ark/config/crd/bases/
grep -r "kind: Agent" samples/
A2A の実装を探す
find . -path "*/a2a*" -type f
grep -r "A2AServer" .
特定の機能を検索する
# Use ripgrep or grep to search
rg "query controller" --type go
grep -r "team coordination" --include="*.go"

ベストプラクティス

  1. /tmp にクローンする：ワークスペースが散らからないよう、必ず /tmp/ark-analysis にクローンします
  2. 最初に移動する：分析コマンドを実行する前に cd /tmp/ark-analysis を実行します
  3. 検索ツールを使う：コード検索には rg（ripgrep）または grep を優先します
  4. CLAUDE.md を確認する：CLAUDE.md ファイルでプロジェクト固有のガイダンスを確認します
  5. 後片付けする：作業が終わったら、必要に応じて一時ディレクトリを削除します：rm -rf /tmp/ark-analysis

ワークフローの例

コントローラーを分析する
git clone [email protected]:mckinsey/agents-at-scale-ark.git /tmp/ark-analysis
cd /tmp/ark-analysis
cat ark/internal/controller/query_controller.go
grep -r "ExecuteQuery" ark/internal/genai/
A2A 統合を理解する
cd /tmp/ark-analysis
find samples/a2a -name "*.py"
cat samples/a2a/simple-agent/src/simple_a2a_server/main.py
cat docs/content/developer-guide/building-a2a-servers.mdx
CRD の仕様を探す
cd /tmp/ark-analysis
ls ark/api/v1alpha1/
cat ark/api/v1alpha1/agent_types.go

コメント

Markdown 対応