Agent 开发实战

Appearance

📚 技能书（Skill Books） ​

技能书是从本书内容中提炼的、可被 AI Agent 直接安装使用的结构化技能包。

人类读者可以将技能书作为「学习路径导航」，按目标驱动地选择性阅读。

什么是技能书？ ​

技能书（Skill Book）将本书多个章节的知识重新组织为面向具体实战目标的行动指南。

特性说明
📋 目标聚焦每本技能书围绕一个实战目标，而非按章节线性排列
🔗 跨章引用从多个章节中提取最相关的知识点和代码示例
📝 SKILL.md 格式符合 Agent 技能系统规范，可直接安装为可执行技能
✅ 自验证设计包含检查点（Self-Verification），确保技能掌握

可用技能书 ​

🟢 入门级 ​

构建你的第一个 Agent ​

ID: first-agent · 目标: 从零搭建一个能感知-推理-执行工具调用的 Agent

涉及章节：

学习目标：

  1. 理解 Agent 的核心定义和五要素（感知、推理、执行、目标、自治）
  2. 实现 LLM + Tools + Memory 的最小 Agent
  3. 掌握 Function Calling 的完整流程

Prompt Engineering 实战 ​

ID: prompt-engineering · 目标: 系统掌握面向 Agent 的 Prompt 设计技巧

涉及章节：

学习目标：

  1. 掌握系统提示词设计的核心原则
  2. 学会 Few-shot / Chain-of-Thought / ReAct 等高级技巧
  3. 优化 Prompt 以提升 Agent 推理质量

🟡 中级 ​

构建 RAG 增强 Agent ​

ID: rag-agent · 目标: 实现检索增强生成，让 Agent 拥有外部知识库

涉及章节：

学习目标：

  1. 理解 RAG 架构的核心组件（Embedding → 向量存储 → 检索 → 生成）
  2. 实现向量检索 + LLM 生成的完整管线
  3. 优化检索质量和上下文窗口利用率

多 Agent 协作系统 ​

ID: multi-agent · 目标: 设计和实现多 Agent 编排方案

涉及章节：

学习目标：

  1. 掌握多 Agent 通信协议设计
  2. 实现 Supervisor / Swarm 等编排模式
  3. 处理多 Agent 系统中的竞态和死锁

Agent 测试与评估 ​

ID: agent-testing · 目标: 建立 Agent 质量保障体系

涉及章节：

学习目标：

  1. 设计 Agent 评估指标体系
  2. 实现自动化测试框架
  3. 建立回归测试和基准测试流程

🔴 高级 ​

生产级 Agent 部署 ​

ID: production-deploy · 目标: 从开发到生产的完整链路

涉及章节：

学习目标：

  1. 设计高可用 Agent 服务架构
  2. 实现监控告警体系
  3. 建立 CI/CD 自动化部署流程

企业级设计模式 ​

ID: enterprise-patterns · 目标: 大规模 Agent 系统的架构模式和最佳实践

涉及章节：

学习目标：

  1. 掌握企业级 Agent 架构的核心模式
  2. 实现安全与权限管理框架
  3. 设计可扩展的 Agent 平台架构

如何安装技能书 ​

方式一：对话安装（推荐） ​

直接告诉你的 Agent：

根据 https://{host}/claude-code-book/agent-api/skills/rag-agent.md 安装这个技能书。

Agent 会自动下载 SKILL.md 并安装到技能系统。

方式二：API 获取 ​

bash
# 列出所有可用技能书
GET /agent-api/skills/index.json

# 获取指定技能书
GET /agent-api/skills/rag-agent.md

方式三：手动安装 ​

  1. 下载对应的 SKILL.md 文件
  2. 放置到 ~/.workbuddy/skills/agent-book-{skill_id}/SKILL.md
  3. 重启 Agent 即可使用

技能书 ID 速查表 ​

ID名称难度章节数
first-agent构建你的第一个Agent🟢 入门3
prompt-engineeringPrompt Engineering 实战🟢 入门2
rag-agent构建RAG增强Agent🟡 中级3
multi-agent多Agent协作系统🟡 中级2
agent-testingAgent测试与评估🟡 中级2
production-deploy生产级Agent部署🔴 高级4
enterprise-patterns企业级设计模式🔴 高级2

技能书与阅读模式的关系 ​

📖 本书 12 卷 52 章
    │
    ├── 👤 人类阅读 ──── 按卷/章顺序 ──── 适合系统学习
    │
    ├── 🤖 Agent API ─── 结构化 JSON ──── 适合按需检索
    │
    └── 📚 技能书 ────── 跨章节重组 ───── 适合目标驱动实战

基于 MIT 许可发布

《Agent 开发：从原理到生产级实践》