主题
章节代码片段索引
本索引用于把 12 章主线、专题、项目线 与 docs/examples/ 下的最小代码示例关联起来。这样做的目的是：当你继续扩写章节正文、补真实代码仓库、制作课程或准备作品集时，可以快速知道每一章最适合挂哪类代码片段和结果样本。
1. 使用方式
建议按下面方式配合使用：
- 看完某一章主线内容后，直接跳到对应示例骨架。
- 如果在补章节正文，可直接从这里挑选“最该出现的代码片段类型”。
- 如果在做项目线，可从这里快速找到相应的最小状态 / 接口 / 响应结构示例。
2. 按章节映射代码片段
| 章节 | 主题 | 推荐示例 | 最值得展示的代码片段 | 推荐样本 |
|---|---|---|---|---|
| 第 1 章 | 转型认知与岗位模型 | 12周学习计划 | 能力差距表、主项目主线与 12 周规划入口 | docs/examples/assets/samples/chapter-01-role-gap-map.json |
| 第 2 章 | 大模型应用基础 | 模板库 | 输入模板、参数基线、结构化输出定义 | docs/examples/assets/samples/chapter-02-model-baseline.json |
| 第 3 章 | 工具调用与单智能体 | 示例1 单Agent工具调用 | 工具 schema、决策循环、前端状态枚举 | docs/examples/assets/samples/example-01-success-response.json |
| 第 4 章 | 检索增强入门（RAG） | 示例2 RAG接口与评测 | 检索接口、引用结构、回答卡片 | docs/examples/assets/samples/example-02-rag-answer.json |
| 第 5 章 | 检索增强进阶 | 示例2 RAG接口与评测 | 实验矩阵、优化日志和配置固化 | docs/examples/assets/samples/chapter-05-rag-optimization-log.json |
| 第 6 章 | 工作流编排 | 示例3 工作流状态机 | 节点状态定义、执行器骨架 | docs/examples/assets/samples/example-03-workflow-state.json |
| 第 7 章 | 多智能体协作 | 示例3 工作流状态机 | 协作协议、角色边界与仲裁规则 | docs/examples/assets/samples/chapter-07-collaboration-protocol.json |
| 第 8 章 | 评测体系建设 | 示例2 RAG接口与评测 | 评测样本字段、结果汇总结构 | docs/examples/assets/samples/example-02-eval-result.json |
| 第 9 章 | 工程化上线能力 | 示例3 工作流状态机 | 上线清单、灰度条件、回滚与状态映射 | docs/examples/assets/samples/example-09-release-checklist.json |
| 第 10 章 | 安全与合规治理 | 章节代码片段索引 | 数据分级、权限矩阵、审计字段与高风险确认 | docs/examples/assets/samples/example-10-security-controls.json |
| 第 11 章 | 作品集构建方法 | 作品集模板 | 项目卡片、证据材料、结果指标与复盘结构 | docs/examples/assets/samples/example-11-portfolio-card.json |
| 第 12 章 | 求职实战与面试表达 | 面试题库 | 高频问题结构、项目讲述与自我介绍模板 | 示例12 面试答题模板 |
3. 按专题映射代码片段
| 专题 | 推荐片段 | 对应路径 |
|---|---|---|
| 上下文工程 | 结构化输出响应体 | docs/examples/assets/samples/example-02-rag-answer.json |
| Agent UI / UX | 状态枚举与任务面板 | 示例3 工作流状态机 |
| 可观测性 | 失败响应与运行状态 | docs/examples/assets/samples/example-01-error-response.json |
| 成本 / 延迟 / 稳定性 | 评测与运行结果样本 | docs/examples/assets/samples/example-02-eval-result.json |
4. 按项目线映射示例
| 项目线 | 推荐先看 | 最适合复用 |
|---|---|---|
| 项目线 A 企业知识库问答 Agent | 示例2 RAG接口与评测 | 引用结构、回答卡片、评测样本 |
| 项目线 B 浏览器 / 办公自动化 Agent | 示例1 单Agent工具调用 | 工具调用结构、状态切换 |
| 项目线 C 多步骤业务工作流 Agent | 示例3 工作流状态机 | 节点状态、任务面板、等待确认态 |
5. 推荐下一步扩写方向
如果你准备继续把这套指南做得更“像课程 / 像书”，下一步最值得补的是：
- 把示例里的最小骨架同步到真实代码仓库。
- 给每个示例补一张真实运行截图。
- 给每个示例补一份真实评测结果或 trace 截图。
- 在章节正文里插入这些片段的相对路径引用。