Voltron项目
一个MCP服务器,为Claude Code提供专门的代理模板团队。为Unity游戏开发、web/全栈开发和通用软件项目构建经过战斗测试的子代理定义的任何项目,再加上scrum主协调器、51个微代理和自我改进循环。
代理团队
核心(所有项目)
| 代理人 | 目的 |
|---|---|
| scrum大师 | 读取积压的工作,将工作分解为代理大小的任务,分配给专家。从不执行。 |
| 项目规划师 | 研究技术堆栈,设计架构,定义数据模型和API合同,生成全面的项目计划供scrum-master分解。 |
| 研究员 | 深度研究专家。使用网络搜索、实时页面导航和结构化提取查找任何信息——技术文档、API、定价、竞争对手、法律文本、社区共识。 |
统一
Unity代理分为两种调用模式。scrum master自动处理Docker代理; 直接的 必须从聊天窗口调用代理(他们需要一个连接了Unity MCP的实时Unity编辑器)。
| 代理 | 目的 | 模式 |
|---|---|---|
| 场景建筑师 | 游戏对象层次结构、预制件、场景合成、变换和组件 | 仅限直接 |
| csharp开发 | MonoBehaviors、ScriptableObjects、游戏系统、编辑器工具 | Docker(文件编辑) |
| 着色器艺术家 | 着色器、材质、视觉特效图、渲染管道功能(URP/HDRP/内置) | Docker(文件)/Direct(预览) |
| 构建验证器 | 控制台监控、编译检查、播放模式烟雾测试 | 仅限直接 |
| 资产管理人 | 文件夹结构、导入设置、命名约定 | Docker(文件夹)/Direct(导入设置) |
网络/全栈
| 代理人 | 目的 |
|---|---|
| 全栈开发 | React/TypeScript前端+Node.js/Express后端 |
| devops工程师 | Terraform、CI/CD、Docker、Fly.io、AWS |
| ui设计师 | CSS、响应式布局、主题化、PWA、可访问性 |
| 质量保证测试仪 | 测试(Vitest/Playwright)、Lighthouse审计、捆绑包分析 |
微代理(俳句层——51名专注工作者)
由子经理分派单动词、单文件任务。每个人都做一件事。
网络
| 代理人 | 目的 |
|---|---|
| 函数编写器 | 将单个函数或实用程序写入指定文件 |
| 中间件编写器 | 将Express/Koa/Hono中间件添加到服务器堆栈中 |
| 商店切片写入器 | 编写Zustand/Redux切片或上下文模块 |
| css编写器 | 编写作用域CSS、Tailwind实用程序或JS样式的CSS |
| 设计令牌编写器 | 编写设计标记文件(颜色、间距、排版) |
统一
| 代理人 | 目的 |
|---|---|
| csharp编剧 | 编写一个新的C#MonoBehaviour或ScriptableObject脚本 |
| csharp成员加法器 | 向现有C#类添加字段、属性或方法 |
| 统一清单编辑器 | 编辑 Packages/manifest.json 或 ProjectSettings 文件 |
开发运维
| 代理人 | 目的 |
|---|---|
| ci工作流编写器 | 编写或更新GitHub Actions/GitLab CI工作流文件 |
| docker编写编辑器 | 在中添加或修改服务 docker-compose.yml |
问答
| 代理人 | 目的 |
|---|---|
| 覆盖跑步者 | 运行报道记者,露出裸露的线条 |
| 测试配置编写器 | 编写或更新Vitest/Jest/Playwright配置文件 |
| 模拟作家 | 为单元测试编写模拟模块或夹具 |
十字
| 代理人 | 目的 |
|---|---|
| 文件修补程序运行器 | 当没有合适的专家时,对任何文件应用有针对性的补丁 |
内部(未搭建成项目)
| 代理人 | 目的 |
|---|---|
| 反射处理机 | 在CI中处理会话反射,对代理模板进行有针对性的改进。在Sonnet 4.6上运行。 |
安装
一个命令设置
git clone https://github.com/7ports/project-voltron.git
cd project-voltron
node scripts/setup.js安装脚本:
- 安装npm依赖项
- 注册
project-voltron克劳德代码中的MCP服务器(全局范围) - 将推荐的allowlist添加到
~/.claude/settings.json因此,代理不需要手动批准常见命令 - 验证Docker是否可用
重新启动Claude代码 运行安装程序以加载新的MCP服务器并分配列表后。
必需:珠子依赖跟踪器
scrum master使用 珠子 用于依赖感知任务编排。 这是强制性的 从v3.4.0开始,代理将拒绝在没有工作的情况下分发工作计划 bd CLI:
npm install -g @beads/bd如果没有珠子,scrum master就会回到手动依赖推理。
自动恢复(v3.6.6+): scrum master的飞行前检查现在可以检测到共享dolt服务器(由配置 dolt.shared-server: true 在 .beads/config.yaml)已因重新启动而成为孤儿并运行 bd dolt start 在计划之前自动重新启动它。这消除了最常见的Windows重启后故障模式,在这种模式下,bd命令出错,显示“端口3308上无法访问Dolt服务器”。为了永久解决问题,代理人 珠子回收 部分提供了 Register-ScheduledTask 自动启动的PowerShell代码段 bd dolt 每次登录时。
重新验证安装
在任何Claude Code会话中:
Call mcp__project-voltron__setup_voltron这可以在不需要终端的情况下检查和修复满负荷表。
亚历山大一体化
Voltron代理商旨在与 亚历山大项目 --一个配套的MCP服务器,维护一个共享的工具设置指南库。当两者都安装好后,代理商会咨询亚历山大 之前 任何工具安装——这是强制性的,不是可选的。
这能实现什么:
- 所有专业代理致电
quick_setup在安装任何工具、库或服务之前——以及search_guides如果没有确切的指南 scrum-master电话get_project_setup_recommendations在规划新项目时,需要专业代理在每个工具设置任务中检查亚历山大- 完成设置后,代理呼叫
update_guide记录发现(平台怪癖、版本说明、工作命令) - 来自会议的工具知识回流到亚历山大港,而不仅仅是进入Voltron的反思管道
内容边界: Alexandria只针对非项目特定的、可重复使用的文档——工具设置指南、平台怪癖、版本说明、API模式。项目特定知识(业务逻辑、自定义架构、团队惯例)属于 CLAUDE.md 以及当地的项目文件,而不是亚历山大。
设置: 在中全局安装两个MCP服务器 ~/.claude.json不需要额外的配置——代理模板已经包含了相关的 mcp__alexandria__* 工具。
看 亚历山大项目 有关设置说明。
MCP工具
| 工具 | 说明 |
|---|---|
list_templates | 列出所有模板,可选择按项目类型筛选 |
get_template | 获取特定模板的完整内容 |
scaffold_project | 将代理模板和Dockerfile直接写入磁盘,用于unity、web、全栈、移动或一般项目。智能合并:跳过现有代理文件,附加到现有CLAUDE.md,保留自定义Dockerfiles。当未指定project_root时,通过文件系统遍历自动检测项目根(查找.git、CLAUDE.md、.mcp.json等);脚手架搭建后需要重新启动克劳德代码。 |
setup_voltron | 从Claude Code中验证和修复Voltron安装——更新全局分配列表并报告MCP/Docker状态 |
get_auto_update_hook | 拿到 .claude/settings.json 挂钩用于现有项目 |
get_agent_usage_guide | 调用和协调代理的使用指南 |
check_for_updates | 检查安装的代理文件是否与当前模板过时 |
update_agent | 获取特定代理的最新内容 |
submit_reflection | 提交一份关于代理绩效的会后反思 |
list_reflections | 列出存储的反射(用于查看待处理的改进) |
run_agent_in_docker | 在Docker容器中以完全权限启动一个专业代理(由scrum master调用) |
start_agent_in_docker | 非阻断剂发射;立即返回container_name和log_path进行轮询 |
get_agent_output | 轮询正在运行的代理容器以获取实时日志输出;显示聊天中的最后N行 |
update_progress | 更新代理任务进度(每次代理调用前后由scrum master调用) |
get_progress | 以格式化的仪表板形式查看当前代理任务进度 |
generate_dashboard | 从进度数据生成独立的HTML仪表板 |
用法
安装后,询问Claude Code:
- *“与Voltron代理商一起为Unity项目搭建脚手架”* →
scaffold_project和project_type: "unity" - *“用Voltron代理商搭建这个网络项目”* →
scaffold_project和project_type: "web" - *“我该如何使用Voltron代理商?”* →
get_agent_usage_guide - *“检查我的代理是否是最新的”* →
check_for_updates - *“将自动更新挂钩添加到此项目”* →
get_auto_update_hook
工作流程
- 脚手架 --奔跑
scaffold_project在项目根目录中使用项目类型 - 配置 --填写
CLAUDE.md使用您的项目细节并设置Docker执行(请参阅脚手架输出) - 研究 --对于新项目,调用
@agent-project-planner研究技术栈与设计架构 - 计划 --调用
@agent-scrum-master与项目计划一起获得结构化的工作分解 - 开发 --根据计划调用专业代理;他们向亚历山大咨询工具设置
- 反映 --scrum-master在阶段完成、阻塞和会话结束时自动提交反射;还将工具发现同步到Alexandria
代理自动更新
scaffold_project 输出a .claude/settings.json 包含a UserPromptSubmit 钩子。这个钩子能跑 scripts/auto-update-agents.js 在每次Claude Code会话开始时。如果安装的版本与本地Voltron安装不同,所有过时的文件都会自动更新到位。
什么会自动更新:
- 所有代理
.md文件在.claude/agents/ Dockerfile.voltron(如果存在的话——只有使用Docker的项目)scripts/voltron-run.sh(如果存在)
什么不是自动更新的 (用户自定义文件):
CLAUDE.md--包含您填写的项目特定上下文.claude/settings.json--您可能已经自定义的钩子配置
A. [VOLTRON] Auto-updated N file(s) 当发生更新时,消息会出现在上下文中。对于添加此功能之前搭建的项目,运行 get_auto_update_hook 获取要手动添加的设置条目。
自我完善
代理人通过以下方式提交会后反思 submit_reflectionscrum master现在会在阶段完成、严重阻塞后和会话结束时自动提交反射。反思在 reflections/ 目录,并由运行的GitHub Actions工作流自动处理 周一/周三/周五10:00 UTC:
- 这
reflection-processor代理(在Sonnet 4.6上运行)读取所有未处理的反射 - 按代理对反馈进行分组,并按频率进行优先级排序
- 将有针对性的改进应用于
src/templates.js - 缓冲补丁版本并提交
- 在更改到达之前打开PR供人工审核
main
合并后,安装了自动更新挂钩的项目将在下一个会话开始时自动接收新模板。没有钩子的项目可以通过以下方式手动进行改进 check_for_updates。也可以从“操作”选项卡手动触发工作流。需要 ANTHROPIC_API_KEY 设置为存储库机密。
Docker执行
scrum master通过以下方式自动启动Docker容器内的每个专业代理 run_agent_in_docker MCP工具。您可以在桌面上正常运行Claude Code——Docker是在幕后处理的。
当scrum主机调用代理时, run_agent_in_docker:
- 为项目上下文加载代理的模板和CLAUDE.md
- 构建Docker镜像
Dockerfile.voltron(首次构建后缓存) - 将项目目录和OAuth凭据装载到容器中
- 运行代理
--dangerously-skip-permissions完全自主执行 - 完成时返回代理的输出
先决条件: Docker必须安装并运行。 Dockerfile.voltron 和 scripts/voltron-run.sh 由生成 scaffold_project启动脚本也可以手动用于独立代理会话。
身份验证(v3.4.1): Docker工具挂载 ~/.claude/.credentials.json:ro 这样Claude Max OAuth登录就可以重复用于代理会话。他们故意这样做 不 安装 ~/.claude 或 ~/.claude.json --后者包含主机路径MCP服务器注册,在启动时挂起Linux容器(60-90秒以上)。身份验证解析顺序:
~/.claude/.credentials.json(如果存在,请安装)CLAUDE_CODE_OAUTH_TOKENenv-var(如果设置,则传递)ANTHROPIC_API_KEYenv-var(如果设置,则传递;保留给CI)
在Windows上,默认情况下OAuth存储在凭据管理器中 ~/.claude/.credentials.json 不存在。跑 claude setup-token 一旦在普通终端中在该路径上实现了一个长期令牌,Voltron Docker代理就会自动获取它。
未来增强: 将每个试剂容器分开,以便在专业试剂之间隔离爆炸半径。
动态模型选择
Voltron根据每个代理的角色为其分配默认模型层。当微代理失败或产生低质量输出时,子经理和协调员可以在每次调用时覆盖此设置。
| 层级 | 模型 | 代理 | 角色 |
|---|---|---|---|
| Opus | claude-opus-4-* | 5 | 协调员和规划师(scrum master、项目规划师、代码分析师、文档编写者、反射处理器) |
| 十四行诗 | claude-sonnet-4-* | 16 | 副经理和领域专家(全栈开发人员、devops工程师、csharp开发人员、qa测试人员等) |
| 俳句 | claude-haiku-4-* | 53 | 微代理--检查、写入、验证、发布层工作者 |
以(权力)否决 通过 model: "sonnet" 或 model: "opus" 到 run_agent_in_docker / start_agent_in_docker 在更高层重试微代理。当输出不令人满意时,指示副经理自动执行此操作。这 list_templates 该工具显示每个代理的默认模型层。
进度可视化
scrum master使用内置的MCP工具跟踪代理任务进度。当创建工作计划时,scrum master会立即将所有任务注册为“排队”——这会触发 实时仪表板 在用户的浏览器中自动打开。
update_progress--记录任务状态更改(排队、正在进行、已完成、失败、已阻止);每次通话时自动重新生成仪表板HTMLget_progress--在聊天窗口中返回格式化的仪表板generate_dashboard--在以下位置生成一个独立的HTML文件.voltron/dashboard.html(每5秒自动刷新一次)
进度数据保存在 .voltron/progress.json.
许可证
麻省理工学院
