# 如何使用本书 {.unnumbered}

## 这本书写给谁

《用 Loop Workflow 驱动企业协作》面向四类读者：

- **客户与售前**：想知道 Loop Workflow 能解决哪类业务问题、落地需要什么前提。
- **实施人员**：要把客户的业务流程配置成可运行的 Workflow，并对接现有系统。
- **流程创建者**：在日常协作中用 Workflow 把重复工作自动化。
- **评估者**：判断一项工作该用普通对话、Task、Scheduled Message、Agent，还是 Workflow。

本书假设你用过即时通讯协作工具；不假设你写过代码或配置过工作流引擎。书中的完整 `loop.plan/v1` 示例都可独立验证；片段和占位输入会明确标注，不能直接当作可运行配置。

## 三条阅读路线

你可以按目标选择路线：

1. **15 分钟体验**：读第一篇，理解 Workflow 的适用场景与四个核心对象，并运行一个最小流程。
2. **2 小时上手**：加上第二篇，完成创建、校验、发布、运行与计划调用（Binding）的配置。
3. **完整交付**：读完可靠流程设计、Extension、企业案例、运营治理与故障排查，能够独立交付与运维。

## 难度标识

案例与练习使用三档难度：

- **入门**：无需写配置，照做即可理解概念。
- **进阶**：需要创建并校验一个 Plan，可能用到 `request_approval` 或 `send_message`。
- **复杂**：涉及多分支、`fan_out`、外部 App/Extension 对接与异常恢复。

## 能力边界

为避免高估或低估平台能力，本书对每项能力标注三档边界：

- **当前可直接使用**：Loop 平台已内置、开箱即用，例如手动运行 Workflow、`request_approval` 审批、Task 看板。
- **需要配置 App 或 Extension**：平台支持 App-hosted Extension 机制，但具体的 Extension、连接与 action 需要安装、选择并授权。例如通过 Gitea/GitHub App 承载的 Extension，让 Agent 用 `loop exec` 读写仓库。
- **需要实施开发**：当前平台未直接提供，需要实施或二次开发。例如对接一个尚未提供 Extension 的内部 ERP。

> **⚠️ 注意：** Extension 是 Agent 通过 `loop exec <extension> <action>` 调用的能力，**不是 Workflow 的节点**。Workflow 用 `send_message` 与 Agent 协作，由 Agent 决定是否调用 Extension；不要把 Extension 写进 Plan 的 `nodes`。