# Claude Workflow Composer：可视化多智能体编码工作流编排工具

> Claude Workflow Composer 是一款可视化桌面应用，让开发者通过拖拽方式编排多智能体编码工作流，支持连接智能体、附加技能和 MCP、配置交接逻辑，并直接导出到 .claude/ 目录。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-07T01:44:45.000Z
- 最近活动: 2026-06-07T01:52:02.164Z
- 热度: 152.9
- 关键词: Claude Code, 多智能体, 工作流编排, 可视化工具, AI 编程助手, MCP, 智能体, 工作流自动化, n8n
- 页面链接: https://www.zingnex.cn/forum/thread/claude-workflow-composer
- Canonical: https://www.zingnex.cn/forum/thread/claude-workflow-composer
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：fayzan123
- 来源平台：GitHub
- 原始标题：claude-workflow-composer
- 原始链接：https://github.com/fayzan123/claude-workflow-composer
- 来源发布时间/更新时间：2026-06-07T01:44:45Z

## 引言：多智能体工作流的痛点

随着 Claude Code 等 AI 编程助手的普及，越来越多的开发者开始探索多智能体（Multi-Agent）协作的工作模式。在这种模式下，不同的智能体负责不同的任务——有的专注于代码审查，有的擅长测试生成，有的精通架构设计——它们通过精心设计的交接逻辑协同工作，共同完成复杂的软件开发任务。

然而，构建这样的多智能体工作流并非易事。目前的实践主要依赖手工编写 YAML 配置文件和智能体定义文件，开发者需要手动创建 `.md` 格式的智能体文件，编写带有特定 frontmatter 的编排器技能，并通过纯文本描述来定义智能体之间的交接逻辑。整个过程缺乏可视化的反馈，开发者无法在运行前直观地看到工作流的结构，也无法方便地分享完整的工作流配置。

Claude Workflow Composer 正是为了解决这些痛点而诞生的。这款工具将自己定位为「面向编码智能体工作流的 n8n」——就像 n8n 让工作流自动化变得可视化一样，Claude Workflow Composer 让多智能体编码工作流的构建变得直观和高效。

## 核心功能：拖拽式工作流编排

Claude Workflow Composer 的核心价值在于将抽象的多智能体协作逻辑转化为直观的可视化界面。开发者可以通过简单的拖拽操作完成复杂的工作流设计：

**智能体节点管理**：从左侧边栏可以将现有的智能体（来自 `~/.claude/agents/`）拖拽到画布上创建引用节点，也可以从「新建/空白智能体」创建自定义节点。引用节点指向已有的智能体文件，而自定义节点则会在导出时生成全新的智能体定义。

**交接逻辑可视化**：通过在不同节点之间拖拽连线，开发者可以定义智能体之间的交接关系。每条连线代表一次智能体切换，可以配置触发条件、标签以及上下文传递（文件、文本、JSON 等）。这种可视化的交接定义方式，远比手工编写文本描述更加直观和不易出错。

**终端状态定义**：任何节点都可以被标记为终端状态——完成（Complete）、升级（Escalated）或中止（Aborted）。这允许开发者明确定义工作流的结束条件，确保工作流在适当的时机优雅地终止。

## 节点编辑：精细化配置每个智能体

选中画布上的任意节点，右侧面板会展示详细的配置选项，允许开发者对每个智能体进行精细化定制：

**基础属性配置**：包括智能体名称、描述、颜色标识等。这些信息不仅用于可视化展示，也会写入到导出的智能体定义文件中。

**系统提示词编辑**：可以直接在界面中编辑智能体的系统提示词（System Prompt），定义该智能体的角色、能力和行为准则。编辑器支持实时预览，方便开发者即时调整。

**工具与技能管理**：可以为每个智能体配置可用的工具（Tools）和技能（Skills）。技能可以从侧边栏的技能库中拖拽添加，工具则通过勾选方式启用。这种模块化的配置方式让智能体的能力组合变得灵活而清晰。

**完成条件定义**：每个智能体都需要定义完成条件（Completion Criteria），即什么情况下认为该智能体的任务已完成，可以进入下一步交接。这是确保工作流正确执行的关键配置。

## 导出机制：从可视化到可执行

工作流设计完成后，开发者可以通过导出功能将其转化为 Claude Code 可识别的配置。导出过程包含以下关键步骤：

**目标目录选择**：可以选择导出到用户级的 `~/.claude/` 目录（全局可用）或项目级的 `./.claude/` 目录（版本可控）。项目级导出特别适合团队协作场景，工作流配置可以与代码库一起版本管理。

**文件预览与冲突检测**：导出前，系统会展示将要写入的所有文件的完整预览。更重要的是，系统实现了所有权检测机制——每个导出的文件都包含特殊的 HTML 注释标记所有权。如果目标位置已存在非本工作流创建的文件，系统会发出警告，避免意外覆盖手工编辑的文件。

**智能体文件生成**：对于自定义节点，系统会生成完整的 `.md` 智能体定义文件，包含 frontmatter（名称、描述、颜色、模型、工具等）、系统提示词、完成条件和技能引用。对于引用节点，则不生成新文件，而是在编排器中使用现有智能体的 slug 进行路由。

**编排器技能生成**：系统通过 BFS 遍历节点/边图，生成自然语言描述的编排步骤，并写入到 `.claude/skills/<workflow-slug>/SKILL.md`。该技能文件设置了 `disable-model-invocation: true`，确保编排器通过 Agent 工具将每个实现步骤委托给对应的子智能体执行。

## 执行与调用：在 Claude Code 中运行工作流

导出完成后，工作流可以通过技能名称在 Claude Code 中直接调用：

```
/workflow-name
```

当执行上述命令时，Claude Code 会加载对应的编排器技能。编排器按照预定义的步骤顺序，通过 Agent 工具调用各个子智能体。每个步骤引用智能体的名称，Claude Code 会解析为对应的 `.md` 文件并加载其系统提示词、工具和完成条件。

这种执行模式的优势在于：工作流的逻辑完全由编排器技能定义，而具体的任务执行则委托给专门的智能体。这既保证了工作流的可控性，又充分发挥了每个智能体的专业能力。

## 技术架构：前后端分离的设计

Claude Workflow Composer 采用了清晰的前后端分离架构：

**前端（React + React Flow）**：基于 React Flow 实现可视化画布，支持背景网格、小地图、缩放控制和拖拽连线。左侧边栏展示可拖拽的智能体和技能，右侧面板提供节点和边的详细编辑功能。状态管理通过自定义的 reducer 实现，并配有 500ms 防抖的自动保存机制。

**后端（Express）**：提供 RESTful API 支持工作流的 CRUD 操作、智能体和技能列表查询、导出预览和实际导出等功能。核心逻辑包括 BFS 遍历、冲突检测、文件生成等，确保导出过程的正确性和安全性。

**存储层**：工作流文件保存在 `~/.cwc/workflows/` 目录，最近文件列表保存在 `~/.cwc/recents.json`，运行时 PID 保存在 `~/.cwc/server.pid`。智能体和技能文件则读写自 `~/.claude/` 目录。

## 快速启动与使用体验

Claude Workflow Composer 的使用门槛极低。开发者只需运行以下命令即可启动：

```bash
npx claude-cwc
```

这会在本地启动服务器并打开浏览器访问 `http://localhost:3579`。无需代码签名，没有 Gatekeeper 摩擦，粘贴命令即可开始使用。停止服务同样简单：

```bash
npx claude-cwc stop
```

启动时，系统会检测 `~/.claude/` 目录是否存在，如果不存在会发出警告提示用户先安装 Claude Code。这种贴心的设计帮助新手快速定位问题。

## 应用场景与未来展望

Claude Workflow Composer 适用于多种场景：

**复杂代码审查流程**：可以设计包含静态分析、安全扫描、风格检查、逻辑审查等多个智能体的代码审查工作流，每个智能体专注特定领域，最后汇总结果。

**多步骤代码生成**：对于需要多轮迭代的代码生成任务，可以设计从需求分析、架构设计、代码实现到测试生成的完整工作流，每个阶段由专门的智能体负责。

**知识库问答系统**：结合检索增强生成（RAG），可以构建包含文档检索、相关性判断、答案生成、事实核查等环节的问答工作流。

未来，随着 Claude Code 生态的持续发展，Claude Workflow Composer 有望成为多智能体工作流编排的标准工具。可能的增强方向包括：支持条件分支和循环的复杂控制流、集成更多第三方工具和服务、提供工作流模板市场等。