基于 MCP 协议的多 AI 编码 Agent 编排服务器，通过 PLAN → ACT → EVAL 工作流调度 37 个专家 Agent 实现可量化的 AI 编码质量保障。
Codingbuddy 是一个基于 MCP（Model Context Protocol）的多 AI 编码 Agent 编排服务器，核心能力在于通过结构化的 PLAN → ACT → EVAL 工作流，将 AI 编码从"无约束生成"提升为"有门控保障"的工程实践。
工作流引擎#
- PLAN → ACT → EVAL 三阶段流水线：Solution Architect + Technical Planner 先规划，领域 Developer Agent 再执行，最后多 Specialist Agent 并行审查
- AUTO 全自动模式：自动循环 PLAN → ACT → EVAL，直到 Critical=0 且 High=0 才交付
- Question-First Planning：需求模糊时先提问澄清，避免基于假设开发
- 质量门控：循环迭代必须清零所有关键/高危问题
Agent 体系（三层架构，共 37 个）#
- Mode Agents（4）：Plan Mode / Act Mode / Eval Mode / Auto Mode
- Primary Agents（18）：Solution Architect、Technical Planner、Frontend/Backend/Mobile/Data Engineer、Security Engineer、DevOps Engineer、Platform Engineer、AI/ML Engineer、UI/UX Designer 等
- Specialist Agents（13）：Architecture、Test Strategy、Security（含 OWASP Top 10）、Accessibility、Performance、Code Quality、SEO、i18n、Integration、Event Architecture、Documentation、Observability、Migration
- Utility Agents（2）：Parallel Orchestrator、Plan Reviewer
可观测性与度量#
- Session Impact Report：每次会话自动生成结构化报告，量化已阻止问题数（按安全/可访问性/性能/代码质量分类）、调度 Agent 数、Checklist 数、模式转换链、上下文决策数
- HUD Statusbar（v5.6.0）：Breathing Buddy Face（阶段表情）、Cost Velocity Indicator（实时消费速率）、Cache Savings Badge（缓存节省金额）、Mode Rainbow Coloring（ANSI truecolor 渐变）、Smart Context Bar（进度条）、Rate-limit Severity Icons
- TUI Dashboard：终端实时可视化，通过
npx codingbuddy tui启动
多工具统一接入#
通过 MCP 协议支持 9 款 AI 编码工具：Claude Code（MCP + Plugin 双模式）、Cursor、GitHub Copilot/Codex、Antigravity (Gemini)、Amazon Q、Kiro、Windsurf、Aider、OpenCode。一套规则集通过工具特定规则文件目录分发，在不同工具间保持一致性。
内置 Skills（可复用工作流）#
ship、retrospective、test-driven-development、systematic-debugging、security-audit、performance-optimization、refactoring、brainstorming
多语言支持#
模式关键词支持英语、韩语（계획/실행/평가）、日语（計画/実行/評価）、中文（计划/执行/评估）、西班牙语（PLANIFICAR/ACTUAR/EVALUAR）；配置文件支持 en / ko / ja / zh / es / pt-br / de / fr 共 8 种语言。
安装与使用#
npm install -g codingbuddy
npx codingbuddy init
在项目 .claude/settings.json 中配置 MCP 接入，或在 AI 对话中直接输入 PLAN / ACT / EVAL / AUTO 关键词触发对应模式。
架构概要#
Yarn 4 monorepo（packages/* + apps/*），核心 MCP Server 位于 apps/mcp-server，规则引擎在 packages/rules/.ai-rules/rules/，Claude Code 插件（Python）在 packages/claude-code-plugin。主要语言 TypeScript（76.4%）、Python（21.1%），MIT 开源。
待确认事项#
- 独立官网暂无，以 GitHub 仓库为唯一官方页面
- npm 包可用性未实际验证
- README 标题称 37 个 Agent，GitHub About 摘要显示 29 个，存在版本描述差异
- Claude Code Plugin marketplace 可用性未验证
- TUI Dashboard 未提供截图或功能边界说明
- 除 Claude Code 外其他工具是否仅通过 MCP 规则文件接入、功能差异待确认