核心用法
Three Minds 是一个真正可执行的多 Agent 协作系统，通过 Claude Code CLI 启动三个具有不同专业人设的 AI agent，在同一工作目录上进行多轮协作直至达成共识。用户通过简单的命令行指令触发任务，系统会自动协调架构师、工程师、审核员（或安全专家、性能工程师、质量审查员等配置）三个角色，每轮依次执行文件读取、代码修改、测试运行等操作，并进行投票表决。支持自定义 JSON 配置以适配不同场景，所有讨论记录和代码改动自动保存为 Markdown 文件。
显著优点
该系统的最大价值在于真正落地执行而非纸上谈兵——每个 agent 都能实际读写文件、运行测试，实现从设计到实现的完整闭环。多视角协作机制有效避免单一 AI 的盲区，共识投票确保最终输出经过充分审视。预设配置覆盖代码审查、论文写作、头脑风暴等场景，自定义配置灵活扩展。自动化的记录保存便于追溯决策过程，与 Claude Code 生态无缝集成降低了上手门槛。
潜在缺点与局限性
首要限制是强依赖 Claude Code CLI，未安装或配置不当则完全无法运行。三个 agent 顺序执行导致整体耗时较长，复杂任务可能需要多轮迭代。--dangerously-skip-permissions 参数虽提升效率，却牺牲了安全确认环节。此外，agent 间通过文件系统间接协作，缺乏直接的上下文共享机制，可能出现信息传递损耗。对于大型代码库，token 消耗和 API 成本显著增加。
适合的目标群体
主要面向需要高质量代码审查的开发者团队、独立开发者处理复杂重构任务、以及追求多视角验证的技术负责人。特别适合代码审查流程不完善的小型团队、需要快速获得架构/安全/性能多维度反馈的个人项目，以及希望自动化部分 PR 审查流程的工程师。教育场景中也可用于演示协作式问题解决过程。
使用风险
安全风险最为突出：子 agent 自动获得文件读写和命令执行权限，可能意外修改或删除关键文件。建议在独立 git 分支或容器环境中运行，避免直接操作生产代码。性能方面，三 agent 顺序调用 Claude API，响应时间和 token 消耗随轮数线性增长，需合理设置 --max-rounds 上限。依赖项风险包括 Claude Code CLI 的版本兼容性、Node.js 环境要求，以及网络稳定性对长会话的影响。