概述

AgentFlow 为你的 AI 编程助手提供一个工作流引擎。它定义如何描述工作流，而不是运行什么工作流。你来决定节点、连接关系以及每个节点做什么。

快速开始

选择你的 AI 助手：

Claude Code

npm install -g @rraft/agentflow
cd your-project
agentflow init --cli claude

在 Claude Code 中输入：/agentflow-create 研究微服务架构，输出对比报告

Codex CLI

npm install -g @rraft/agentflow
cd your-project
agentflow init --cli codex

在 Codex 中输入：/agentflow-create 研究微服务架构，输出对比报告

Cursor

npm install -g @rraft/agentflow
cd your-project
agentflow init --cli cursor

在 Cursor 中输入：/agentflow-create 研究微服务架构，输出对比报告

GitHub Copilot

npm install -g @rraft/agentflow
cd your-project
agentflow init --cli copilot

在 Copilot Chat 中输入：/agentflow-create 研究微服务架构，输出对比报告

OpenCode

npm install -g @rraft/agentflow
cd your-project
agentflow init --cli opencode

在 OpenCode 中输入：/agentflow-create 研究微服务架构，输出对比报告

斜杠命令

agentflow init 后，你的 AI 助手将获得以下命令：

| 命令 | 说明 | |---------|-------------| | /agentflow-create <描述> | 根据描述创建工作流 | | /agentflow-run | 执行当前工作流 | | /agentflow-status | 查看执行状态 | | /agentflow-visualize | 生成交互式 HTML DAG 图 | | /agentflow-edit <修改> | 修改工作流 |

也可以直接自然语言交流——"帮我编排一个工作流：先调研，再对比，最后写报告"。

生成的文件结构

your-project/
├── .agentflow/                  # 工作流工作区
│   ├── workflow.yaml            # DAG 定义
│   ├── nodes/                   # 节点定义与输出
│   ├── skills/                  # Agent Skills（编辑器、执行器、可视化器）
│   ├── memory/                  # 跨节点记忆（决策、约束）
│   └── capabilities/            # 自定义能力
└── [agent 引导文件]              # 各 Agent 专属集成

CLI 命令

| 命令 | 说明 | |---------|-------------| | agentflow init | 初始化 .agentflow/ 工作区 | | agentflow scaffold <预设> | 从 6 个内置预设生成工作流 | | agentflow create <描述> | 根据描述生成工作流 | | agentflow visualize | 生成交互式 HTML DAG 图 | | agentflow validate | 校验工作流定义 | | agentflow status | 查看执行进度 |

核心概念

| 概念 | 说明 | |---------|-------------| | Workflow | 定义在 .agentflow/workflow.yaml 中的 DAG | | Node | 具有输入/能力/输出边界的工作阶段 | | Capability | 可复用的技能包（提示词 + 工具 + 约束） |

License

MIT