第 X 章：章节标题
本章导读
- 核心问题：本章要回答的一个核心工程问题。
- 关键词：Agent、Context、Tool、Skill 等核心术语。
- 学习产出：读者读完本章应能设计、判断或实现什么。
所属部分：第 X 部分：部分名称
对应文章：Anthropic Engineering — 文章标题 / 或“综合工程章节”
官方链接：https://example.com
本章状态：精修稿
1. 本章要解决什么问题
用工程问题开场，不直接堆概念。
推荐写法：
本章要解决的问题不是“什么是 X”，而是：当我们构建企业级 Agent 时，为什么必须设计 X？
本节建议回答：
- 这个问题在真实 Agent 系统中什么时候出现；
- 如果不解决会导致什么失败；
- 本章会给出什么工程解法。
2. 对应 Anthropic 文章 / 工程来源
如果有直接对应文章，写：
- 文章标题：
- 官方链接：
- 相关主题：
如果是综合章节，写：
- 主要参考文章：
- 工程来源：
- 与前后章节关系：
3. 核心观点
提炼本章最重要的 3～8 个观点。
要求：
- 不做逐字翻译；
- 用自己的工程语言重构；
- 每个观点最好能落到“系统设计决策”。
4. 工程视角重新解释
从软件工程、后端架构、企业系统建设角度解释本章概念。
建议结构：
概念定义
↓
为什么 Prompt 层不够
↓
需要哪些系统模块
↓
企业落地时的边界和约束
5. 架构图 / 流程图
本章主图：图 X-1 图名
Mermaid 源文件：diagrams/chapter-XX-topic.mmd
阅读提示：说明这张图应如何阅读，以及它和本章主线的关系。
正文中可以保留必要的内联 Mermaid，但原则是：
- 一章至少一张主图；
- 主图放在
diagrams/目录； - 内联图只用于局部解释；
- 正式发布前统一图号和图片导出格式。
6. Java / Spring Boot 落地方案
说明如果用 Java / Spring Boot 实现，需要哪些模块、接口和数据结构。
推荐结构：
模块职责
核心接口
关键数据结构
运行流程
治理与观测
代码示例应偏接口和结构，不在本阶段展开完整工程实现。
7. 企业案例 / 贯穿案例
每章都应映射到统一案例：
CI 失败分析 Agent
项目：order-service
Build：#4312
PR：#882
要求：
- 不重复长篇背景；
- 只解释本章概念如何作用于该案例；
- 关键事实以
references/case-study-ci-failure-agent.md为准。
8. 与其他框架对比 / 常见误区
根据章节内容选择是否包含框架对比。
常见对比对象：
- OpenAI；
- Google Gemini；
- LangChain / LangGraph；
- AgentScope；
- AutoGen；
- Claude Code / Codex / Pi Agent。
常见误区要求：
- 不只列口号；
- 每个误区说明为什么错；
- 最好给出替代做法。
9. 本章小结
用 3～5 条总结本章。
推荐写法：
本章不是要说明 X 很重要，而是要说明 X 在 Agent Runtime 中承担什么工程职责。
10. 实践任务
给读者一个可以动手完成的小任务。
任务建议：
- 可在纸面完成；
- 可作为 Java 示例工程的未来输入；
- 尽量围绕 CI 失败分析 Agent 展开。
语言风格约定
- 优先使用“工程系统”“运行时”“边界”“验证”“治理”等工程语言。
- 避免“神奇”“自动理解一切”“完全自主”等夸张表达。
- 对 Agent 能力的描述必须包含边界和失败模式。
- 对 Memory、Tool、MCP、Skill 等术语使用
references/glossary.md中的推荐写法。 - Java 类名和接口名使用英文，例如
ContextProvider、ToolRegistry、AgentRuntime。