用一句话描述你想要的 AI 助手，它帮你把整个 Agent 搭出来。
Agent Builder 是一个"造 Agent 的 Agent"——你用自然语言告诉它你想要什么样的 AI 助手，它会设计架构、生成所有配置文件、审查质量，最终交付一个可以直接运行的 Claude Code Agent。
不用模板，不填表单。每个 Agent 都是从零根据你的需求定制的。
告诉它你的想法，它帮你设计整套架构：
你: 我想做一个旅行规划助手，能帮用户穷举所有日期和目的地的组合，
用矩阵对比找到最便宜的方案。
Agent Builder:
✓ 理解你的需求，追问关键细节
✓ 设计架构（2 Skills + 2 Sub-agents + 1 Command）
✓ 在目标路径生成 10 个配置文件
✓ 自动审查：格式、命名、权限、上下文隔离
✓ 交付一个可以直接 `claude` 启动的 Agent
上面这个例子是真实的——Travel Price Hacker 就是用 Agent Builder 生成的。
对任何已有的 Claude Code Agent 配置做质量审查：
你: 帮我看看 /path/to/my-agent 这个 Agent 配置写得怎么样
Agent Builder:
→ 扫描所有配置文件
→ 按 9 个维度评分（CLAUDE.md 质量、Skill 触发覆盖度、
Sub-agent 权限、上下文隔离...）
→ 输出评分报告 + 具体改进建议
为已有 Agent 规划新增能力，先设计后实现：
你: 这个 Agent 还需要一个自动生成周报的功能
Agent Builder:
→ 分析现有架构，选择最合适的组件类型
→ 给出完整的实现方案（文件结构、组件设计、交互流程）
→ 等你确认后再动手
确认规划方案后，一键生成所有文件：
你: 方案没问题，开始搭吧
Agent Builder:
→ 生成所有新文件
→ 修改受影响的已有文件
→ 调用 reviewer 校验一致性
你: /agent-status /path/to/some-agent
Agent Builder:
→ Agent Status: some-agent
CLAUDE.md — 85 行, 身份: "代码审查专家"
Skills (3) — review-pr, check-style, suggest-fix
Sub-agents (1) — code-analyzer: sonnet | tools: Read, Grep
Commands (2) — /review, /status
Rules (1) — security-check
Hooks — PostToolUse: 1 hook
Settings — Allowed tools: 8
Agent Builder 通过自然语言触发，不需要记命令：
💬 创建 Agent：
我想做一个代码审查助手，能自动分析 PR 的改动，给出评审意见和改进建议。
💬 审查配置：
帮我看看 ~/projects/my-bot 这个 Agent 的配置质量怎么样。
💬 规划功能：
我的 Agent 现在只能处理文本，我想让它也能处理图片。
💬 实现方案：
方案看起来不错，开始实现吧。
💬 查看状态：
/agent-status ~/projects/my-bot
Agent Builder 本身也是一个 Claude Code Agent，由以下组件协作：
| 技能 | 触发方式 | 做什么 |
|---|---|---|
| create-agent | "创建/搭建/做一个 Agent" | 端到端流程：需求澄清 → 架构设计 → 文件生成 → 质量审查 |
| review-agent | "审查/检查/评估 Agent" | 按 9 维度评分，输出报告和改进建议 |
| plan-feature | "规划/添加功能" | 分析现有架构，设计新增能力的实现方案 |
| build-feature | "开始实现/搭建" | 按已确认方案生成文件，调用 reviewer 校验 |
| 子代理 | 模型 | 权限 | 做什么 |
|---|---|---|---|
| agent-reviewer | Sonnet | 只读 (Read, Glob, Grep) | 审查生成结果的结构、命名、权限、上下文隔离，输出评分报告 |
只有一个子代理，且只有只读权限——它只审查，不修改。这是刻意的设计：减少子代理数量降低延迟，只读权限防止误写。
| 命令 | 做什么 |
|---|---|
/agent-status <path> |
扫描目标路径，输出 Agent 配置概览（Skills/Sub-agents/Commands/Rules/Hooks 数量和摘要） |
| 规则 | 做什么 |
|---|---|
| context-isolation | 强制上下文隔离：所有文件操作用绝对路径、永不修改 Builder 自身文件、生成内容不引用 Builder |
create-agent 技能内置了 8 份 Claude Code 组件指南，覆盖每种组件的格式规范和最佳实践：
| 参考文档 | 覆盖内容 |
|---|---|
| claude-md-guide | CLAUDE.md 写法：加载层级、推荐长度、结构模板 |
| skills-guide | Skill 格式：YAML frontmatter、description 触发机制、references 用法 |
| agents-guide | Sub-agent 设计：frontmatter 字段 (camelCase)、模型选择、工具权限 |
| hooks-guide | Hook 配置：10 种事件类型、handler 类型、匹配器语法 |
| commands-guide | Command 格式：纯 Markdown、$ARGUMENTS、与 Skill 的区别 |
| rules-guide | Rule 设计：路径作用域、优先级、glob 模式 |
| settings-guide | settings.json：4 级优先级、权限层级、MCP server 配置 |
| architecture-patterns | 三种架构模式：Minimal / Standard / Full-service + 决策树 |
review-agent 技能有 1 份质量评分标准（quality-rubric），定义 9 个评审维度和加权评分公式。
用户输入（自然语言）
│
├─ "创建一个 Agent" ──→ create-agent 技能
│ │
│ ├─ 1. 需求澄清（对话）
│ ├─ 2. 架构设计（读取 8 份参考文档）
│ ├─ 3. 文件生成（写入目标路径）
│ └─ 4. 质量审查 ──→ agent-reviewer 子代理（只读）
│ └─ 评分报告 → 按需修正
│
├─ "审查这个 Agent" ──→ review-agent 技能
│ └─ 读取 quality-rubric → 9 维度评分
│
├─ "加个功能" ────────→ plan-feature 技能
│ └─ 分析现有架构 → 输出方案
│
├─ "开始实现" ────────→ build-feature 技能
│ └─ 按方案生成 → agent-reviewer 校验
│
└─ /agent-status ─────→ agent-status 命令
└─ 扫描 → 输出概览
┌─────────────────────────────────────────────────┐
│ context-isolation 规则（始终生效） │
│ · 所有写入用目标绝对路径 │
│ · 永不修改 Builder 自身文件 │
│ · 生成内容不引用 Builder │
└─────────────────────────────────────────────────┘
- 已安装 Claude Code CLI
cd agent-builder
claude然后用自然语言告诉它你想创建什么 Agent 即可。
- Travel Price Hacker — 旅行方案穷举比较 Agent，用矩阵对比所有日期×目的地组合的成本
为什么不用模板？
目标 Agent 的领域差异极大：旅行规划、代码审查、数据分析、内容创作……模板容易变成"看似通用但不贴合"的结构。Agent Builder 选择从需求出发，每次从零设计最佳组件组合。代价是每次创建需要更完善的流程和校验——这由 create-agent 技能的 4 步流程和 agent-reviewer 的自动审查来承担。
为什么要上下文隔离？
Agent Builder 是一个"造 Agent 的 Agent"。如果 Builder 的身份信息泄漏到生成的 Agent 中（比如目标 Agent 的 CLAUDE.md 提到了"元 Agent"），目标 Agent 会对自己的身份感到困惑。所以隔离通过三层保障：CLAUDE.md 规则 + context-isolation 强制规则 + agent-reviewer 事后审查。
为什么只有一个子代理？
子代理越多，延迟和协调成本越高。Agent Builder 只在真正需要隔离的环节（质量审查）使用子代理，其他工作都由主 Agent 直接完成。而且 reviewer 只有只读权限，杜绝了审查过程中误写文件的风险。