# 用 AgentTeam Agent 建立团队协作

本目录是独立可构建的 Markdown 书稿工程。
`SUMMARY.md` 是唯一章节顺序来源，Pandoc 负责合并 Markdown 并转换为 Typst，Typst 负责中文排版和 PDF。

## 本书定位

`agent-practice-tuts` 面向刚开始在 AgentTeam 里使用 Agent 的研发团队。
本书重点回答 4 类问题：

- Agent、Role、Skill 与 Runtime 分别是什么。
- 团队应该如何组织一套可持续的多 Agent 协作方式。
- 哪些 Skills 值得优先接入，以及它们分别适合哪个阶段。
- 如何把一次性的聊天经验沉淀成可复用的角色、技能、模板与协作约束。

本书不试图覆盖流程编排能力、所有产品表面功能，或所有模型差异。
它更像一本面向通用开发团队的上手与治理手册。

## 构建

```bash
cd books/agent-practice-tuts
make doctor
make bootstrap
make check
make
```

默认输出为 `dist/agent-practice-tuts.pdf`。

## 目录职责

- `book.yaml`：书名、作者、语言等出版元数据。
- `SUMMARY.md`：章节列表与构建顺序的唯一来源。
- `manuscript/`：可直接在 Git 中阅读的 Markdown 正文。
- `media/`：出版媒体与图示预留目录。
- `templates/`：本书专用模板。
- `STYLE.md` / `TERMINOLOGY.md`：本书的写作与术语约束。
- `build/`、`dist/`：生成目录，不进入 Git。

共享基础设施位于 `books/_infra/`，包括：

- 统一 `Brewfile`
- 统一 `book.mk`
- 统一 `scripts/`
- 统一 `theme/`

## 写作原则

- 先讲协作边界，再讲具体操作。
- 先讲推荐默认值，再讲例外和变体。
- 先讲可直接复制的模板，再讲抽象原则。
- 任何治理约束，都优先落在可被 Agent 标准接入的资产上：Role、Skill、Memory、模板、检查脚本。