用途:当用户询问 Ark 中某功能如何工作、想了解 Ark 的架构或实现、需要检查 Ark 源码/CRD/控制器,或提到要分析 Ark 仓库时,可使用本技能。
主要能力:通过克隆仓库并浏览内容来分析 Ark 代码库。仓库结构包括:ark/ 为 Kubernetes operator 与默认执行器(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/ 文档站。
必要用法:先将仓库克隆到临时位置: git clone git@github.com:mckinsey/agents-at-scale-ark.git /tmp/ark-analysis cd /tmp/ark-analysis 随后用 rg 或 grep 搜索代码。常见任务包括查找控制器(ls ark/internal/controller/)、查找 CRD(ls ark/config/crd/bases/)、查找 A2A 实现(find . -path "/a2a" -type f)及搜索特定功能。建议始终克隆到 /tmp/ark-analysis、先导航再分析、优先使用 ripgrep/grep、查看 CLAUDE.md 获取项目指引,完成后可执行 rm -rf /tmp/ark-analysis 清理。
限制:资料未提供该技能的收费、平台兼容性、性能表现或额外安装步骤等信息。