# 章节模板（templates/chapter.md）

本模板适用于第一至第四篇的**教学章节**。每章聚焦一项能力，按固定槽位组织，使读者预期一致、便于 Review 与统稿。

复制本文件到 `manuscript/part-<篇>-<slug>/` 并改名为 `<两位章号>-<slug>.md`（章号对应 `SUMMARY.md` 顺序），将 `{{…}}` 字段替换为正文。（目录以工程批次的 `SUMMARY.md` 为准。）

**关于 10 个槽位**：下方“槽位骨架”给出全书唯一的 10 个 canonical 槽位标记与填写指南；“完整范例”是填好的样例，不再含槽位标记。检查器只扫描 `manuscript/**/*.md`，不计本模板与 `STYLE.md` / `TERMINOLOGY.md`（见 `STYLE.md` §15）。作者生成章节文件时，10 个槽位标记各出现一次；教学章节必须实质填写“目标 / 边界 / 媒体槽位”，其余按章节相关性填写或写“本章不涉及 X，见第 N 章”，不得静默删除标记。

## 字段表

| 字段 | 必填 | 说明 |
| --- | --- | --- |
| `{{part}}` | 是 | 所属篇，如“第一篇 · 认识 Workflow” |
| `{{chapter-no}}` | 是 | 章号，与 `SUMMARY.md` 顺序一致 |
| `{{chapter-title}}` | 是 | 章标题，名词性，不超 20 字 |
| `{{minutes}}` | 是 | 预计学习时长（分钟） |
| `{{prereq}}` | 是 | 前置章节或能力 |
| `{{objectives}}` | 是 | 学习目标，2–5 条，可勾选 |
| `{{media-list}}` | 否 | 本章媒体清单（图号 → 文件名） |

## 槽位骨架

> 复制本节正文到你的文件。全书 10 个 canonical 槽位标记各出现一次；填写时保留每个标记、替换其下占位为正文。教学章节必须实质覆盖“目标 / 边界 / 媒体槽位”；其余按需填写或显式声明不涉及。

<!-- slot: 目标 -->
**本章目标**：2–5 条可勾选要点，写“学完能做什么”（可观察行为），不写空泛词。

<!-- slot: 边界 -->
**适用边界**：“覆盖 / 不覆盖 / 假设”三栏；进阶内容指向后续章节。

<!-- slot: 提示词 -->
**提示词**：若涉及提示词 / 自然语言创建，给出可复制的提示词（用 `text` 代码块）。不涉及写“本章不涉及提示词”。

<!-- slot: 流程 -->
**流程**：用步骤列表或 `mermaid` 描述运行过程；图存 `media/`。

<!-- slot: 配置 -->
**配置**：用 `yaml`，字段与真实 schema 一致，必填项不留空。不涉及写“本章不涉及配置”。

<!-- slot: 异常 -->
**异常**：列出本章场景常见 2–4 种失败：现象 → 原因 → 处置；报错用 `text` 代码块。失败语义与 runtime 一致。

<!-- slot: 审批 -->
**审批**：若涉及 `request_approval`，说明谁审批、驳回行为；无 timeout / 升级。不涉及写“本章不涉及审批，见第 N 章”。

<!-- slot: 外部系统 -->
**外部系统**：若涉及对接，给出由 Agent 承担的最小示例。不涉及写“本章不涉及外部系统”。

<!-- slot: 验收 -->
**验收**：可勾选清单，与“本章目标”一一对应。

<!-- slot: 媒体槽位 -->
**媒体槽位**：用媒体标记登记图位（命名 `fig-<章号>-<序号>-<slug>.png`），正文成稿后补图与图题。

## 完整范例（worked example：第 0 章 认识 Workflow）

> 填好的样例，展示成稿样貌。术语以 `TERMINOLOGY.md` 为准。

| 字段 | 值 |
| --- | --- |
| 所属篇 | 第一篇 · 认识 Workflow |
| 章号 / 标题 | 0 / 什么是 AgentTeam Workflow |
| 预计时长 | 15 分钟 |
| 前置 | 能登录 AgentTeam 并进入某工作空间 |

### 本章目标

学完本章你将能够：

- 用一句话向同事解释什么是 Workflow 以及它能解决哪类问题。
- 区分四个一等对象：工作流 Workflow（代码名 `Plan`）、触发器 Trigger（`Binding`）、调用 Invocation、运行 Run；并理解节点 Node 是什么。
- 在 UI 中定位到 Workflow 的创建入口与运行历史。

### 适用边界

- **覆盖**：Workflow 的定义、四个一等对象、UI 总览。
- **不覆盖**：从零创建一个 Workflow（见第 4 章）、节点类型详解（见第三篇）。
- **假设**：你已能登录 AgentTeam 并进入某个工作空间。

### 提示词

本章不涉及提示词，见第 4 章“从提示词创建 Workflow”。

### 流程

一个 Workflow 的生命周期：创作 Plan →（可选）部署 Binding → 产生 Invocation → 执行 Run → 等待 / 完成。

<!-- media: fig-00-01-workflow-lifecycle.png -->
图 0-1 Workflow 生命周期：Plan → Binding → Invocation → Run。

### 配置

本章不涉及配置，见第 4 章。

### 异常

本章为概念入门，不涉及具体失败处置；运行态失败语义见 `TERMINOLOGY.md` §5/§6/§8。

### 审批

本章不涉及审批，见第三篇“可靠流程设计”。

### 外部系统

本章不涉及外部系统。

### 验收

- [ ] 能说出四个一等对象及其代码名。
- [ ] 能在 UI 找到 Workflow 列表与某次 Run 的详情。
- [ ] 能解释为什么没有“HTTP 节点 / LLM 节点”。

### 媒体槽位

<!-- media: fig-00-01-workflow-lifecycle.png -->

### 收尾

- 小结：Workflow 是可复用的编排逻辑（`Plan`），由触发器或手动调用产生一次 `Invocation`，再由一次 `Run` 执行；外部能力由 Agent 经 `send_message` 回调承担。
- 下章预告：第 1 章从零创建并运行你的第一个 Workflow。

## 自检（提交前）

- [ ] 10 个 canonical 槽位标记齐全（定义见“槽位骨架”）；不涉及处已写指向说明。
- [ ] 无 `TBD`/`TODO`；所有 `{{…}}` 已替换。
- [ ] 代码块均带语言；YAML 字段与 schema 一致；switch 等表达式用 `||` 而非 `or`。
- [ ] 媒体引用真实存在或为媒体标记登记。
- [ ] 通过 `make check`。