UmaDev
像一个真正的开发团队那样工作的编码智能体：驱动你已有的 Claude Code / Codex / OpenCode 等 CLI，把一条需求变成带证据链的可交付项目。
按维度查看评分与理由
证据显示较完整的治理设计：plan/guarded/auto 信任档位、不可逆操作始终确认、单写者规则、隔离分支、云嵌入需显式双开关、凭据归属明确保留给底层 CLI、审计落盘 .umadev/audit。但均为 README 声明，源文件无法验证实现细节；且 SECURITY.md 披露 1.0.74 npm 包被恶意发布，属真实供应链事故，虽有加固（无令牌发布、签名、来源证明），dependency_security 不能给满分。各条均有明确扣分点：声明充分但缺实现级佐证。
失败信息处理是亮点：doctor 命令、降级路径（BM25 兜底、检索失败软降级、critic 失败停摆而非伪造通过）、诚实报告失败。扣分点：自一致性依赖声明间的对齐（README 与 Cargo.toml 版本 1.0.x 徽章 vs 1.1.1 存在轻微出入），底层 CLI 可用性完全依赖外部工具，无本地证据。
capability_boundaries 突出：明确 Plan 档位在不同厂商权限面不等同沙箱、Grok 需真实会话验证、不支持的问题面如实上报而非模拟、角色裁定仅为咨询性。扣分点：五后端的行为差异使环境适配部分依赖各厂商版本漂移（CI 有契约测试缓解），受众与场景仅 README 描述。
信息架构优秀：完整目录、分层架构图、规格文档 UMADEV_HOST_SPEC_V1、多语言 README、明确安装路径（npm/原生/源码，含嵌入模型说明）与 MIT LICENSE。扣分点：CHANGELOG、FAQ、维护者响应机制在提供文件中未见内容本体；SECURITY.md 的 1.0.74 事故说明历史上发布链路曾被攻破，维护责任虽写明邮箱但发布安全有前科。
边际价值清晰：不重造模型端点，而是为既有 CLI 增加计划、验收底线、证据包、质量门，差异化真实。扣分点：输出可用性与成本收益只停留在声明（TUI、proof pack 等），静态审查无法确认实际体验；重治理流程对小任务的成本控制仅靠深度分级声明。
声明可追溯性较好：条款数（34）、检查数（113）、CI 固定到提交哈希与 SHA-256、恶意包哈希公开。扣分点：大量强断言（如 fail-closed 边界、学习记忆的隔离）在提供文件内无法交叉验证；事实与推断在文档中大体分离但部分营销化语言（'works like a real dev team'）混合了愿景与事实。
- 该项目历史上发生过真实供应链事故：npm 上的 [email protected] 被确认为非本仓库产出、含安装期恶意载荷；务必通过官方 registry 安装并核对版本 ≥1.0.75，避免使用第三方镜像缓存。
- 信任档位与沙箱强度并非在五个底层 CLI 上一致；plan 模式不等于硬沙箱，使用前应验证所选后端的实际权限面。
- 本评审为静态源码审查，README 中大量治理声明（113 项检查、fail-closed 边界、记忆隔离）未在提供文件内验证，采用前建议自行审计关键路径。
- 发布者身份未经验证；维护联系邮箱为个人 QQ 邮箱，企业采购前应核实实体身份。
这个 Agent 能做什么，适合哪些场景？
UmaDev 是一个用 Rust 编写的开源（MIT）编码智能体，它不持有任何模型端点，而是驱动五个一等后端之一——Claude Code、Codex、OpenCode、Grok Build 或 Kimi Code——被选中的底座所连接的模型就是它的“大脑”。它的核心能力是基于角色的团队编排：九个席位（八个专家角色加一个协调者）通过共享黑板工件和结构化 RoleVerdict 协作，写代码走单一写者主会话，评审角色在并行的新会话中给出咨询性结论。其规范性来源是 UMADEV_HOST_SPEC_V1（34 条规范条款），由 113 项治理内容检查兜底，覆盖密钥泄露、emoji 图标、硬编码颜色、AI 模板化 UI 等问题。它将一个完整构建拆解为“澄清—调研—PRD/架构/UI-UX—计划—前端—预览—后端—质量门—交付”九阶段流程，产出磁盘上的文档、源码、runtime-proof.、proof-pack 压缩包和记分卡，并输出 SOC 2 / ISO 27001 / EU AI Act 合规映射。适合需要一个可审计交付流程、而非单纯“问 AI 写代码”的工程师与团队。
用户通过 umadev TUI 聊天界面或 umadev run "需求" --backend <id> CLI 提交需求。协调者先路由意图（Chat / Explain / QuickEdit / Debug / Build），澄清歧义，再决定深度。重构建进入九阶段交付链：调研合并网络搜索与本地知识库到 output/<slug>-research.md；起草 PRD（含 EARS 验收标准）、架构（含 openapi.*）、UI/UX 三份核心文档；生成依赖计划 .umadev/plan. 并渲染为实时清单（可用 /plan 调整）；前端、后端写者角色串行驱动底座 CLI 写代码，每个文件经 113 项治理检查的前写/提交钩子；前端↔后端契约由 umadev-contract 解析 API 表为 OpenAPI 并交叉校验所有 fetch/axios 调用。质量门独立运行构建、测试、lint、契约检查、运行时探针（umadev verify --runtime 产出 runtime-proof.）。交付产物包括 release/proof-pack-*.zip、scorecard-*.html 和合规映射（umadev report）。知识检索本地优先：纯 Rust BM25 为底线，可选本地向量（multilingual-e5-small，candle 后端）经 RRF 融合，云嵌入需 OPENAI_EMBED_KEY 与 UMADEV_ALLOW_CLOUD_EMBED=1 双重显式开启。审计证据以 JSONL 写入 .umadev/audit/。还可作为 MCP 服务器（umadev mcp serve）向其他工具暴露治理能力。
- 独立开发者想用已有的 Claude Code 或 Codex 订阅，把一条完整需求（如“做一个带 Postgres 后端的待办应用”）变成带 PRD、验收标准和交付证据的项目，而不是零散的代码片段。
- 工程团队需要在 AI 生成代码落地前强制检查密钥泄露、不安全构造和模板化 UI，并把证据链映射到 SOC 2 / ISO 27001 合规控制项。
- 接手已有代码库（brownfield）的工程师可用
umadev adopt检测技术栈、索引源码、反向推导 API 契约后再做增量修改。 - 需要在 CI 中以无人值守模式运行可审计构建的团队，用
umadev run配合--mode auto和umadev ci治理扫描。 - 希望在小型改动上不召开“全员大会”的开发者：路由器会把 bugfix 走轻量路径，
/quick可强制轻量通道，小编辑保持小编辑。 - 使用 Kimi Code 或 Grok Build 等 ACP v1 协议底座的用户，希望在其上获得与其他三个底座一致的编排与治理体验。
这个 Agent 有哪些优点和局限？
- 独特点：以九席位角色编排替代单轮提示，评审角色在隔离会话中返回结构化 RoleVerdict，角色之间只通过共享工件和结论沟通，避免上下文互相污染。
- 信任建立在确定性验收底线之上：构建/测试/lint/契约交叉校验和运行时探针独立于模型自评，交付失败会如实上报而非谎报完成。
- 113 项治理检查 + 34 条规范条款 + JSONL 审计链 + SOC 2 / ISO 27001 / EU AI Act 合规映射，是企业环境落地 AI 编码的少见完整治理层。
- 本地优先检索（纯 Rust BM25 为底线，向量可选）和捆绑知识语料，无云知识服务依赖；云嵌入需双重显式开关，默认不外传。
- 单一 Rust 二进制、MIT 许可、支持 macOS（Apple Silicon/Intel）、Linux（x86_64/ARM64，glibc/musl）和 Windows x86_64，提供 npm 与免 sudo 原生两种安装路径。
- 强依赖外部底座：必须已安装并登录五个受支持 CLI 之一，UmaDev 本身不含模型，离线模式只产出带 TODO 的模板而非真实代码。
- 采用成本不低：完整九阶段流程对简单任务是显著开销，需理解 plan/guarded/auto 信任级别、确认门和审计产出的运作方式。
- ACP 底座（Grok Build / Kimi Code）存在能力差异：Grok 目前使用有界新会话交接（持久恢复在沙箱证明前禁用），只有 Codex 支持经过验证的同轮 turn/steer，其他底座会排队或拒绝活跃轮输入。
- 源码构建者需自行解决本地嵌入模型（
--features vector-local+ config./tokenizer./model.safetensors），否则退化为仅 BM25；NFS/SMB 及跨身份写锁场景不受支持。 - 评审角色结论是咨询性的，缺失必需评审只会触发运行暂停而非通过或拒绝，用户需自行处理暂停的运行。
如何安装或部署这个 Agent？
方式一（npm）：npm i -g @umatech/umadev，然后运行 umadev；遇到权限或 PATH 问题运行 umadev doctor 获取修复提示。方式二（原生安装，无需 Node/npm/sudo）：macOS/Linux 执行 curl -fsSL https://umadev.goder.ai/install.sh | bash；Windows PowerShell 执行 irm https://umadev.goder.ai/install.ps1 | iex。可用 UMADEV_VERSION 和 UMADEV_INSTALL_DIR 控制版本与目录。还需安装并登录至少一个底座 CLI，例如：npm i -g @anthropic-ai/claude-code && claude auth login，或 npm i -g @openai/codex && codex login，或 npm i -g opencode-ai && opencode auth login，或 Grok Build（curl -fsSL https://x.ai/cli/install.sh | bash + grok login），或 npm i -g @moonshot-ai/kimi-code && kimi login（Node.js ≥ 22.19）。源码构建：git clone https://github.com/umacloud/umadev.git && cd umadev && cargo build --release --features vector-local（需要 Rust 1.88+；本地向量还需自行放置兼容的模型文件）。
如何使用这个 Agent？
运行 umadev 启动聊天 TUI，首次运行会让你选择一个底座。直接输入需求（如“给报告页加 CSV 导出”）自动路由；或用 /run <需求> 明确启动完整构建，/quick <任务> 走轻量路径，/goal <目标> 持续工作直到目标达成。关键命令：/plan 查看和调整实时计划，/continue 通过确认门或重试暂停的评审，/mode plan|guarded|auto 切换信任级别，/preview 启动前端预览，/verify 输出一致性报告，/doctor 自检。脚本化使用：umadev run "需求" --backend claude-code --mode guarded（在 docs_confirm 门暂停），umadev continue 批准门禁，umadev deploy --run 部署并产出 deploy-proof.，umadev report 生成合规映射。注意不可逆操作（合并/重置、删除、部署、推送）在所有信任级别都需确认；UmaDev 永不自行合并或推送。