# Superpowers-UML：让 AI 代理通过 UML 建模协作设计的开发工作流

> Superpowers-UML 是一个创新的 Claude Code 插件，它将 AI 代码生成与 UML 建模相结合，创建了一种人机协作的软件设计工作流。AI 代理将需求和设计表示为 UML 模型，用户与 AI 通过建模协作完善设计，然后 AI 基于用户批准的 UML 模型创建实现计划。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-03T22:15:05.000Z
- 最近活动: 2026-04-03T22:21:08.943Z
- 热度: 159.9
- 关键词: Claude Code, UML, AI辅助开发, 软件设计, 建模工具, 人机协作, Astah, 代码生成
- 页面链接: https://www.zingnex.cn/forum/thread/superpowers-uml-ai-uml
- Canonical: https://www.zingnex.cn/forum/thread/superpowers-uml-ai-uml
- Markdown 来源: ingested_event

---

# Superpowers-UML：让 AI 代理通过 UML 建模协作设计的开发工作流

## 项目概述

**Superpowers-UML** 是一个基于 Claude Code 的插件项目，它创新性地将 AI 辅助编程与 UML 建模相结合，创建了一种全新的软件开发工作流。该项目是对原始 Superpowers 项目的扩展，专门针对 AI 时代的软件开发需求进行了重新设计。

项目的核心理念是：在让 AI 生成代码之前，先让 AI 和人类通过 UML 建模达成对系统设计的共识。这种方法既保留了 AI 的高效代码生成能力，又通过可视化的 UML 模型确保了设计的可理解性和可审查性。

## 核心工作流

Superpowers-UML 定义了一套完整的人机协作设计流程：

### 1. AI 驱动的 UML 建模

AI 代理首先将软件需求和设计规格表示为 UML 模型。这包括：
- 用例图：描述系统功能和用户交互
- 类图：定义系统的静态结构
- 时序图：描述对象间的动态交互
- 活动图：展示业务流程和控制流
- 状态图：描述对象的生命周期

### 2. 人机协作设计评审

用户和 AI 代理通过 UML 建模工具（Astah Pro）协作完善设计：
- 用户审查 AI 生成的 UML 模型
- 提出修改意见或补充需求
- AI 根据反馈调整模型
- 迭代直到达成设计共识

### 3. 基于 UML 的实现计划

一旦 UML 模型获得用户批准，AI 代理将：
- 分析 UML 模型的结构和约束
- 制定详细的实现计划
- 生成对应的代码结构
- 逐步实现各个组件

## 技术架构

### 依赖组件

Superpowers-UML 的工作流依赖于以下工具链：

#### Claude Code
作为 AI 代理的运行环境，提供：
- 代码生成和编辑能力
- 工具调用接口（Tools）
- 子代理（Subagents）功能
- 钩子（Hooks）机制

#### Astah Pro
专业的 UML 建模工具（v11.0+），提供：
- 可视化的 UML 建模界面
- 模型验证和一致性检查
- 代码生成和逆向工程
- 团队协作支持

#### Astah Pro MCP
Astah Pro 的 MCP（Model Context Protocol）插件（v0.2.0+），实现：
- Claude Code 与 Astah Pro 的双向通信
- UML 模型的导入导出
- 实时模型同步

### 插件安装

在 Claude Code 中安装 Superpowers-UML 插件：

```bash
# 添加插件市场
/plugin marketplace add https://github.com/takaakit/superpowers-uml.git

# 安装插件
/plugin install superpowers-uml@superpowers-uml-dev

# 重新加载插件
/reload-plugins
```

## 使用流程

### 准备工作

1. 安装并启动 Astah Pro（确保 MCP 插件已安装）
2. 在项目目录打开终端
3. 启动 Claude Code 并允许 MCP 工具：
   ```bash
   claude --allowedTools "mcp__plugin_superpowers-uml_astah-pro-mcp__*"
   ```

### 启动设计工作流

在 Claude Code 中执行：

```bash
/brainstorming
```

这将启动完整的设计工作流，AI 将引导你完成从需求到 UML 模型的整个过程。

### 设计策略定制

Superpowers-UML 本身不强制特定的设计方法论，AI 代理可以自由选择设计方法。如果需要指定特定的设计策略（如领域驱动设计 DDD），可以：

1. 准备设计策略文档（如 DDD Reference）
2. 在工作流开始前让 AI 参考该文档
3. 明确要求 AI 按照指定策略进行设计

## 实际案例

### 案例：Java 桌面 AI 聊天应用

**需求**：创建一个桌面 AI 聊天应用
**代理**：Claude Code with Sonnet 4.6
**用时**：90 分钟
**产出**：
- 完整的 UML 设计文档（用例图、类图、时序图等）
- 可运行的 Java AI 聊天应用程序
- 清晰的设计决策记录

这个案例展示了该工作流在实际项目中的效率——仅用 90 分钟就完成了从需求到可运行代码的完整开发周期。

## 设计理念与原则

### AI 参考标准

Superpowers-UML 中的 AI 代理遵循以下标准：

- **OMG 规范**：理解 UML 的标准定义和语义
- **敏捷建模（Agile Modeling）**：遵循轻量级、实用的建模原则
- **迭代增量**：支持渐进式设计和实现

### 设计哲学

1. **模型优先**：在编码前先建立共识模型
2. **可视化沟通**：利用 UML 作为人机沟通的桥梁
3. **可审查性**：设计决策可追溯、可审查
4. **渐进细化**：从高层设计逐步细化到实现细节

## 使用成本考量

根据项目维护者的经验，使用 Superpowers-UML 与 Claude Code Sonnet 4.6 约 40 分钟会达到 Pro 计划的 5 小时 Token 限制。因此，对于频繁使用该工作流的用户，Max 计划可能更合适。

## 灵活的工作流入口

Superpowers-UML 支持从工作流的任意阶段开始：

1. 发送提示 "List superpowers-uml commands" 查看可用命令
2. 根据当前项目状态选择合适的命令
3. 例如：
   - 已有需求文档，从建模阶段开始
   - 已有 UML 模型，从代码生成阶段开始
   - 已有部分实现，从模型同步阶段开始

## 许可与归属

- 原始 Superpowers 项目：版权所有 © Jesse Vincent，MIT 许可证
- Superpowers-UML 的修改和新增内容：CC0 1.0 Universal（公共领域）许可证

所有改进建议都将以 CC0 许可证发布，确保最大程度的开放和共享。

## 总结

Superpowers-UML 代表了 AI 辅助软件开发的一个重要发展方向——从单纯的代码生成转向人机协作的完整设计工作流。通过将 UML 建模引入 AI 开发流程，它解决了纯代码生成方式中设计意图难以传达和审查的问题。

这种方法特别适合：
- 需要清晰架构设计的复杂系统
- 团队协作开发项目
- 对设计质量有较高要求的场景
- 希望保留设计文档作为知识沉淀的团队

对于已经在使用 Claude Code 的开发者，Superpowers-UML 提供了一种升级开发流程、提升代码质量的新途径。

---

**项目地址**：https://github.com/takaakit/superpowers-uml

**依赖项目**：
- Superpowers：https://github.com/obra/superpowers
- Claude Code：https://claude.com/product/claude-code
- Astah Pro：https://astah.net/products/astah-professional/
- Astah Pro MCP：https://github.com/takaakit/astah-pro-mcp