mcpField
A
Ark Analysis

Ark Analysis

github.com/mckinsey开发4320 次安装今天更新
代码仓库

关于 Ark Analysis

用于分析 Ark 代码库的技能，面向想了解其架构、实现或资源定义的开发者。它指导克隆仓库，并通过目录定位控制器、CRD 和 A2A 实现。

主要功能

  1. 01指导克隆 Ark 仓库
  2. 02介绍代码库目录结构
  3. 03提供控制器与 CRD 查找方法
  4. 04提供 A2A 实现搜索方法
  5. 05列出代码分析工作流

适用场景

  1. 01了解 Ark 功能的实现方式
  2. 02检查控制器或 CRD 定义
  3. 03查找 A2A 集成代码
  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