# Uatu：Claude Code的AI编排框架与智能体协同系统

> 专为Claude Code设计的AI编排框架，通过规则、钩子和命令三层架构，实现主动建议、多智能体执行、规范驱动开发和提示词质量辅导。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-03T18:14:56.000Z
- 最近活动: 2026-04-03T18:25:29.336Z
- 热度: 163.8
- 关键词: Claude Code, AI编排, 智能体, 软件开发, 工作流, 多智能体, 代码审查, TDD, Jira集成, 开发者工具
- 页面链接: https://www.zingnex.cn/forum/thread/uatu-claude-codeai
- Canonical: https://www.zingnex.cn/forum/thread/uatu-claude-codeai
- Markdown 来源: ingested_event

---

# Uatu：Claude Code的AI编排框架与智能体协同系统

在AI辅助编程工具日益普及的今天，如何有效管理和编排AI智能体的工作流程成为开发者面临的新挑战。Uatu作为一款专为Claude Code设计的AI编排框架，通过三层架构为开发者提供了系统化的解决方案。

## 什么是Uatu

Uatu是一个AI编排框架，旨在为Claude Code提供主动建议、多智能体执行、规范驱动开发和提示词质量辅导能力。它的设计理念是安装一次即可在任何项目中使用，无需手动编辑CLAUDE.md文件。

框架名称"Uatu"源自漫威漫画中的观察者（The Watcher），寓意其持续观察项目状态并提供智能建议的能力。

## 三层架构设计

Uatu通过三个层次运作，每个层次承担不同的职责：

### 第一层：规则（Rules）

规则层位于`.claude/rules/uatu-core.md`，每次会话自动加载。它告诉Claude主动建议命令、辅导提示词质量，并自动使用结构化调试和代码审查流程。这一层是框架的基础，确保AI行为的一致性和可预测性。

### 第二层：钩子（Hooks）

钩子在Claude Code的生命周期事件中触发，实现自动化工作流程：

- **提示词评分**：评估用户输入的提示词质量
- **智能体建议**：基于文件模式推荐合适的智能体
- **测试缺失警告**：当检测到代码变更时提醒缺少测试
- **分支保护**：防止在受保护分支上执行危险操作
- **自动格式化**：保持代码风格一致性
- **检查点保存**：定期保存工作进度

这些钩子让开发流程更加自动化，减少人工干预的需求。

### 第三层：命令（Commands）

命令层提供7个斜杠命令，供用户在需要显式控制时使用。与自动化的钩子不同，命令层让用户在需要时能够精确控制AI行为。

## 核心命令详解

### /status — 全面态势感知

这是每个会话开始时应该运行的第一个命令。它提供项目的完整状态概览，包括：

- 当前Sprint进度和待办事项
- 分支状态和提交历史
- 工作树（worktree）状态
- 上次检查点信息
- 本周工作时间统计

使用`--all`参数可以查看所有项目的状态，适合多项目开发者。

### /orchestrate — 智能多智能体执行

这是Uatu最强大的功能之一。用户只需描述任务，系统会自动分析并选择合适的工作流，无需手动选择模式。

**自动检测机制：**

- 包含"修复"、"错误"、"500"等关键词 → 触发4阶段调试流程（捕获→隔离→修复→验证）
- 包含"重构"、"迁移"等关键词 → 触发架构审查→并行重构→测试→审查流程
- 包含"审计"、"漏洞"等关键词 → 触发安全审计→审查→架构检查流程
- 其他情况 → 触发特性工作流（研究→规划→波次执行→审查）

**可组合标志：**

| 标志 | 效果 |
|------|------|
| `--tdd` | 每个智能体先编写失败测试，再实现功能 |
| `--e2e` | 所有波次完成后生成Playwright端到端测试 |
| `--review` | 每个波次后进行两阶段审查（规范对齐+质量） |
| `--dry-run` | 仅显示计划不执行，等待批准 |
| `--verify` | 波次之间运行测试套件，失败时停止 |
| `--scope <paths>` | 将智能体限制在指定文件/目录 |
| `--no-commit` | 执行但不提交，由用户手动审查和提交 |
| `--jira <KEY>` | 链接到Jira：读取验收标准、创建分支、完成时更新状态 |

执行过程中，用户可以看到清晰的阶段划分和进度追踪，包括并行智能体的数量、计划验证状态、波次执行进度等。

### /research — 深度研究模式

当需要深入理解代码库的某个领域时使用。系统会生成研究计划，并行执行多个研究任务，最后综合发现形成结构化报告。

### /debug — 结构化调试

自动收集错误上下文，应用系统化的5Why根因分析方法，生成可执行的修复计划。这比传统的试错调试更高效。

### /spec — 规范驱动开发

从用户故事生成技术规范，创建验收标准，并生成测试计划。这确保了开发工作始终围绕明确的需求进行。

### /review — 智能代码审查

执行多维度代码审查，包括安全扫描、性能分析、可维护性评估和测试覆盖率检查。这比人工审查更全面、更一致。

### /ship — 一键交付

运行完整的交付流程：最终验证→生成变更日志→创建提交→推送到远程→可选创建拉取请求。这简化了发布流程，减少了遗漏步骤的风险。

## 安装与配置

### 新机器（一次性设置）

```bash
# 1. 克隆并添加到PATH
git clone git@github.com:alterans-tech/uatu.git
cd uatu && ./setup.sh && source ~/.zshrc

# 2. 安装用户级MCP服务器
uatu-setup
```

这会全局安装Sequential Thinking、Claude Flow和Context7 MCP服务器。

### 新项目安装

```bash
cd /path/to/your-project
uatu-install
```

Uatu会创建`.uatu/`、`.claude/rules/`、`.claude/commands/`、钩子和配置文件。Claude Code会立即开始使用该框架，无需手动编辑CLAUDE.md。

**安装配置文件：**

```bash
uatu-install                           # 标准版（钩子+规则+命令+技能）
uatu-install --profile minimal         # 仅钩子+规则（最轻量）
uatu-install --profile full            # 包含智能体的完整版
uatu-install --languages typescript,python  # 仅安装指定语言的规则
```

### 现有项目（已有CLAUDE.md）

同样的命令。Uatu会在现有CLAUDE.md前添加标题（从不覆盖），创建`.claude/rules/uatu-core.md`（由Claude Code自动加载），并安装钩子。现有项目配置会被保留。

## 实际应用场景

### 场景一：新功能开发

开发者描述需求："为已发货订单添加邮件通知"

Uatu自动识别这是特性开发，触发研究→规划→波次执行→审查流程。研究阶段并行分析现有邮件服务架构、通知模板系统；规划阶段生成技术方案；波次执行阶段分配任务给不同智能体；最后进行代码审查。

### 场景二：生产环境Bug修复

开发者描述："修复部署后登录500错误"

Uatu识别到Bug关键词，触发4阶段调试流程。捕获阶段收集错误日志和复现步骤；隔离阶段定位问题代码；修复阶段实施解决方案；验证阶段确认修复有效。

### 场景三：代码重构

开发者描述："将认证逻辑重构为独立服务"

Uatu识别重构关键词，触发架构审查→并行重构→测试→审查流程。首先评估当前架构；然后并行执行多个重构任务；接着运行测试确保功能完整；最后进行质量审查。

## 设计哲学与价值

Uatu的设计体现了几个关键理念：

**自动化优先**：通过钩子实现大量自动化，减少开发者的认知负担。提示词评分、测试警告、自动格式化等功能让开发者专注于核心逻辑。

**智能路由**：/orchestrate命令的自动检测机制消除了选择困难。开发者只需描述问题，系统选择最佳方案。

**可组合性**：各种标志可以组合使用，适应不同场景的需求。TDD、E2E测试、代码审查等功能可按需启用。

**渐进式采用**：从最小安装到完整功能，开发者可以根据需要选择适合的配置。现有项目也能无缝集成。

**生态系统集成**：与Jira、GitHub等工具的集成让AI工作流融入现有开发流程，而不是创建新的孤岛。

## 结语

Uatu代表了AI辅助开发工具的演进方向——从单一功能的代码补全，到系统化的工作流编排。通过规则、钩子和命令三层架构，它为Claude Code带来了企业级的AI编排能力。随着AI在软件开发中扮演越来越重要的角色，这类编排框架将成为开发团队的标配工具。