光与智能
EN
如何成为 Claude 架构师
第 7 / 710 min read

第七章：实战练习与资源

光读是不够的。通过构建才能成为 Claude 架构师。本章提供覆盖每个领域的结构化练习，以及深入学习的资源。

01 顶点项目：客户支持解决方案智能体

这个单一项目触及全部五个领域。端到端构建它。

需求

组件领域
协调器 + 2 个子智能体（查询 + 解决）领域 1：编排
客户查询、订单查询、退款处理的 MCP 工具领域 2：工具设计
带团队标准的 CLAUDE.md，测试文件的 .claude/rules/领域 3：配置
显式升级标准，边界情况的少样本示例领域 4：提示工程
持久案例事实块，结构化错误传播领域 5：上下文管理

架构

客户消息
   │
   ▼
┌─────────────────┐
│     协调器       │
│                  │
│  - 分解          │
│  - 路由          │
│  - 综合          │
└───────┬──────────┘
   ┌────┴────┐
   ▼         ▼
┌────────┐ ┌──────────┐
│ 查询    │ │ 解决      │
│ 智能体  │ │ 智能体    │
└────────┘ └──────────┘

实现清单

  • 智能体循环，正确处理 stop_reason
  • 子智能体具有隔离上下文（无共享记忆）
  • 带声明-来源映射的结构化上下文传递
  • 程序化前置条件门控：在验证账户前阻止退款
  • PostToolUse 钩子：跨工具规范化日期格式
  • 工具调用拦截钩子：阻止超过 $500 的退款
  • 持久案例事实块（永不摘要）
  • 人工升级的结构化交接协议
  • 四种错误类别及正确的 isRetryable 标志
  • 有效空结果 vs 访问失败的区分

测试场景

  1. 正常路径： 客户因产品缺陷请求退款，低于 $500，账户已验证
  2. 前置条件门控测试： 未验证账户即尝试退款 — 应被阻止
  3. 钩子测试： 超过 $500 的退款请求 — 应重定向到人工升级
  4. 多关注点请求： 客户同时有账单问题和产品问题 — 两者都处理
  5. 歧义客户： 搜索返回多个匹配 — 智能体要求澄清
  6. 明确的人工请求： 客户说"我要人工服务" — 立即升级，不进行调查

02 顶点项目：多智能体研究系统

需求

构建包含三个子智能体的协调器：

子智能体角色工具（最多 4-5 个）
网络搜索查找当前信息search_web、fetch_page、extract_quotes
文档分析分析上传的文档read_document、extract_data、summarize_section
综合将发现整合为报告verify_fact、format_output

实现清单

  • 协调器广泛分解（用"AI 对创意产业的影响"测试 — 必须涵盖音乐、写作、电影，不仅仅是视觉艺术）
  • 网络搜索和文档分析的并行子智能体生成
  • 智能体间传递结构化元数据（来源 URL、文档名称、页码、发布日期）
  • 综合智能体在最终输出中保留归因
  • 冲突来源标注两个值，不任意选择
  • 数据有限区域的覆盖度标注
  • 迭代优化：协调器评估综合结果，针对空白重新委派

03 顶点项目：CI/CD 代码审查管道

需求

组件构建什么
非交互式审查-p 标志配合 --output-format json
独立审查实例与代码生成会话分离
多遍架构逐文件分析 + 跨文件集成
增量审查仅报告新的或未解决的问题

实现清单

  • 使用 claude -p 和 JSON Schema 输出的 CI 脚本
  • 包含测试标准和可用 fixture 的 CLAUDE.md
  • 测试文件（**/*.test.tsx）和 API 文件（**/api/**）的路径特定规则
  • 严重度校准的少样本示例
  • 显式标准：标记什么 vs 跳过什么
  • 独立审查实例（不与代码生成同会话）
  • 增量审查上下文：包含先前发现，仅报告新问题

04 顶点项目：结构化数据提取管道

需求

组件构建什么
带 tool_use 的 JSON Schema必填、可选、可空字段，带 "other" 的枚举
验证-重试循环发送回错误，模型自我纠正
批处理用 Message Batches API 处理批量文档
置信度路由低置信度字段路由到人工审查

实现清单

  • 带全面 JSON Schema 的工具定义
  • 可能缺失数据的可选/可空字段（防止捏造）
  • 歧义情况的 "unclear" 枚举值
  • 验证-重试循环：捕获格式不匹配和语义错误
  • 区分可重试的错误和确实不存在的信息
  • 通过 Message Batches API 使用 custom_id 进行批处理
  • 失败处理：仅重新提交失败的文档
  • 带校准阈值的字段级置信度分数
  • 不同文档格式（表格、叙述、引用）的少样本示例

05 速查：领域权重与核心概念

领域权重最重要的单一概念
1. 智能体架构27%子智能体拥有隔离上下文 — 一切都要显式传递
2. 工具设计与 MCP18%工具描述是主要的选择机制
3. Claude Code 配置20%CLAUDE.md 层级 — 团队标准放项目级
4. 提示工程20%要明确 — 具体标准胜过模糊指令
5. 上下文与可靠性15%永远不要摘要事务性数据 — 使用持久案例事实

06 学习资源

Anthropic 官方文档

资源涵盖内容
Agent SDK 概述智能体循环机制、子智能体模式
使用 Claude Agent SDK 构建智能体钩子、编排、会话
Agent SDK Python 仓库 + 示例实操代码：钩子、自定义工具、fork_session
Claude Code 的 MCP 集成服务器作用域、环境变量扩展、项目 vs 用户配置
MCP 规范 + 社区服务器协议理解、何时用社区 vs 自定义
Claude Agent SDK TypeScript 仓库工具定义模式、结构化错误
Claude Code 官方文档CLAUDE.md 层级、rules 目录、斜杠命令
Anthropic 提示工程文档少样本模式、显式标准、结构化输出
Anthropic API Tool Use 文档tool_use、tool_choice 配置、JSON Schema 强制

推荐 Anthropic 课程

  1. Building with the Claude API — 核心 API 机制
  2. Introduction to Model Context Protocol — MCP 基础
  3. Claude Code in Action — 实用 CLI 操作
  4. Claude 101 — Claude 通用能力

社区资源

资源涵盖内容
Claude Code CLI 速查表命令、技能、钩子、CI/CD 标志
创建完美的 CLAUDE.md真实团队配置模式、MCP 集成
Everything Claude Code 仓库上下文管理模式、暂存文件、压缩策略

07 考试反模式速查表

在所有领域中牢记这些：

反模式为什么错正确方法
解析自然语言判断循环终止有歧义且不可靠检查 stop_reason 字段
任意迭代上限截断有用工作或浪费迭代让模型通过 stop_reason 发信号
假设子智能体共享记忆它们不共享在提示中显式传递一切
高风险场景用提示强制失败率非零程序化钩子和门控
模糊的工具描述导致误路由带边界的具体描述
"保守一些"作为标准应用不一致定义显式类别和示例
基于情绪的升级沮丧 ≠ 复杂度使用三个有效触发条件
摘要事务性数据丢失关键数字和日期持久案例事实块
多文件单遍审查注意力稀释多遍：逐文件 + 跨文件
同会话生成和审查推理偏见独立审查实例
阻塞工作流用批处理 API无延迟 SLA阻塞用同步，隔夜用批处理

现在去构建吧。你不需要证书来成为 Claude 架构师。你需要的是知识和证明它的项目。