版本：v1.0 | 定位：项目思想内核，指导所有设计决策 Github 地址
一、一句话定义
AgentFlow 是一个 AI Agent 工作台——以"人辅助 AI"为范式，节点即能力，工作流即流程，自然语言即接口，AI 自主执行，人仅在关键点决策。
价值 = 节点的可组合性 × 工作流的自动化执行力 × 自学习闭环的增益
二、设计哲学
2.1 范式迁移：从 AI 辅助人到人辅助 AI
当前主流（AI 辅助人）：
人驱动 → AI 执行 → 人审查 → AI 修改 → 人确认 → …
人是执行主体，AI 是工具
AgentFlow（人辅助 AI）：
人描述需求 → 匹配/组装执行方案 → AI 自主执行 → 关键点决策 → 完成
AI 是执行主体，人只做必要决策
设计推论：
- 能自动决策的绝不让人决策；必须让人决策的，必须附带充分上下文
- "是否继续"不是有效审批，"架构选 A 还是 B"才是
- 异常时优先自动回退，而非等待人工操作
2.2 节点面向对象，工作流面向过程
| 概念 | 范式 | 定义 | 类比 |
|---|---|---|---|
| 节点 | 面向对象 | 最小能力集，独立存在、独立调用 | 积木块 |
| 工作流 | 面向过程 | 一类任务的标准处理流程，组合节点、含自验证策略与审批点配置 | 搭建说明书 |
关键设计决策：
- 节点不依附于工作流，它是独立的能力原子
- 工作流可视为一个大节点，但不做嵌套组合——保持扁平
- 节点本质是一个 MD 文档（skill/agent 的描述），自然语言描述即定义
2.3 自然语言即接口
这是与 DIFY 等平台的核心差异：
| 维度 | DIFY 等 | AgentFlow |
|---|---|---|
| 创建节点 | 手动配置参数、编写代码 | 自然语言描述即节点定义 |
| 编排工作流 | 拖拽连线、手动配置 | 自然语言描述需求，系统自动匹配/组装 |
| 使用门槛 | 面向专业人员 | 面向非专业人员 |
| 可扩展性 | 需开发插件 | 写一段描述即可扩展 |
本质：DIFY 是给专业用户的编排工具，AgentFlow 是让 AI 理解意图并自主执行的工作台。
三、执行策略
3.1 任务匹配
用户描述任务
↓
LLM 一次推理：同时判断最匹配的工作流 & 所需节点
↓
命中已有工作流 → 按 SOP 自动执行（含自验证 + 审批点）
↓ 未命中
匹配节点动态组装 → 组装执行
↓ 组装失败
降级为裸 Agent 执行
3.2 安全保障
┌──────────────────────────────────────────────┐
│ 快照（Snapshot） │
│ 每步执行前 Git commit，支持精确回滚到任意步骤 │
│ │
│ 断点（Breakpoint） │
│ 工作流中的暂停点，面向开发者调试与深度控制 │
└──────────────────────────────────────────────┘
原则：快照是自动的安全网，断点是可选的调试工具，二者都不打断默认的自动执行流。
3.3 自学习闭环（远期）
任务执行完成
↓
用户手动标记"值得沉淀"（远期：结合完成度/执行时间自动判断）
↓
将执行路径固化为工作流
↓
后续相同任务自动匹配此工作流
↓
越用越好
四、核心原则
原则一：自动执行是默认，人工介入是例外
- 好流程不需要人反复决策；某环节总需人介入，说明流程不成熟
- 每个执行单元应包含自验证（lint/test/typecheck），异常优先自动回退
- 用户只看结果和质量报告，执行过程可折叠
原则二：自然语言是第一接口
- 任何能力（节点/工作流）都应能用自然语言描述清楚
- 降低复杂度不是隐藏复杂度，而是从根本上不需要复杂度
- 非专业人员能用，才是设计成功
原则三：最佳实践是核心资产
- 引擎是壳，节点和工作流是核
- 节点极度简单——一段 MD 描述即注册
- 工作流从真实执行中沉淀，而非凭空设计
五、关键术语
| 术语 | 定义 |
|---|---|
| 节点（Node） | 最小能力集，面向对象，可独立调用，本质为 MD 文档描述 |
| 工作流（Workflow） | 一类任务的标准处理流程，面向过程，组合节点完成复杂任务，含自验证策略与审批点配置 |
| 沉淀（Precipitation） | 将成功执行路径固化为可复用的工作流 |
| 自验证（Self-Validation） | 执行单元内置的自动校验（lint/test/typecheck） |
| 快照（Snapshot） | 每步执行前的 Git commit，用于精确回滚 |
| 断点（Breakpoint） | 工作流中的暂停点，面向开发者调试 |
| 裸 Agent（Bare Agent） | 无匹配工作流和节点时的降级执行模式 |
