Claude Code 不只是聊天式编程助手,它内置了一套完整的 Agent 技能体系,覆盖从需求规划到代码审查的全流程。本文介绍这些核心能力、常用工具和典型工作流。

核心技能一览

Claude Code 内置 11 个专业 Agent,每个聚焦一个特定职责:

技能 职责 触发时机
planner 复杂功能的实施规划 接到复杂需求时
architect 系统设计决策 涉及架构选型时
tdd-guide 测试驱动开发指导 新功能 / Bug 修复
code-reviewer 代码审查 写完代码后
security-reviewer 安全分析 涉及认证、支付、用户数据
build-error-resolver 修复构建错误 构建失败时
e2e-runner E2E 测试 关键用户流程验证
refactor-cleaner 死代码清理 代码维护阶段
doc-updater 文档更新 功能变更后
rust-reviewer Rust 代码审查 Rust 项目
harmonyos-app-resolver HarmonyOS 应用开发 HarmonyOS / ArkTS 项目

常用工具

RTK 优化命令

RTK(Rust Token Killer)是 CLI 输出过滤工具,在命令输出到达 Claude 之前进行压缩,节省 60-90% token 消耗

# 构建 / 测试
rtk cargo build          # Cargo 构建输出压缩 80-90%
rtk cargo test           # 测试失败信息压缩 90%
rtk vitest run           # Vitest 输出压缩 99.5%
rtk playwright test      # Playwright 输出压缩 94%
​
# 代码检查
rtk tsc                  # TypeScript 错误压缩 83%
rtk lint                 # ESLint 违规压缩 84%
​
# Git 操作
rtk git diff             # Diff 压缩 80%
rtk git log              # 日志压缩
rtk git status           # 状态压缩

并行 Agent

独立任务同时执行,无需串行等待:

# 同时执行三个独立任务
1. Agent 1: 安全分析 auth 模块
2. Agent 2: 性能审查 cache 系统
3. Agent 3: 类型检查 utils 工具

多视角分析

复杂问题拆分多个角色独立审查:

  • 事实审查员 — 验证逻辑正确性

  • 高级工程师 — 评估架构和可维护性

  • 安全专家 — 检查安全漏洞

  • 一致性审查员 — 检查风格和命名统一

  • 冗余检查员 — 发现重复代码


工作流:什么时候用什么

标准工作流

需求进来
  │
  ├─ 复杂功能 ──────→ planner(规划方案)
  │                      │
  │                      ▼
  │                   tdd-guide(测试先行)
  │                      │
  │                      ▼
  │                   code-reviewer(代码审查)
  │
  ├─ Bug 修复 ──────→ tdd-guide(写测试定位问题)
  │                      │
  │                      ▼
  │                   code-reviewer(审查修复)
  │
  ├─ 架构决策 ──────→ architect(设计方案)
  │
  ├─ 安全相关 ──────→ security-reviewer(安全审计)
  │
  └─ 构建失败 ──────→ build-error-resolver(定位修复)

实际示例

场景 1:新功能开发

你: "给用户中心加一个批量导出功能"
​
Claude Code 自动触发:
1. planner → 拆分任务、识别依赖
2. tdd-guide → 先写测试用例
3. 实现代码
4. code-reviewer → 审查实现质量
5. 更新文档

场景 2:安全敏感改动

你: "修改登录接口的认证逻辑"
​
Claude Code 自动触发:
1. security-reviewer → 审查认证流程
2. tdd-guide → 补充安全测试用例
3. 实现代码
4. code-reviewer → 二次审查

场景 3:构建失败

你: "npm run build 报错了"
​
Claude Code 自动触发:
1. build-error-resolver → 分析错误堆栈
2. 定位问题文件
3. 修复并验证

配置建议

自动触发规则

在项目的 CLAUDE.md 中配置 Agent 触发规则,让 Claude Code 自动选择合适的 Agent:

## Agent 规则
​
- 复杂功能请求 → 使用 planner agent
- 代码修改完成 → 使用 code-reviewer agent
- Bug 修复或新功能 → 使用 tdd-guide agent
- 架构决策 → 使用 architect agent
- 认证 / 支付 / 用户数据改动 → 使用 security-reviewer agent

RTK 集成

将 RTK 加入 PATH,Claude Code 执行命令时自动使用:

# ~/.claude/CLAUDE.md 中添加
所有 CLI 命令使用 rtk 前缀,例如:
- rtk cargo build
- rtk npm test
- rtk git diff

总结

场景 推荐 Agent 配合工具
复杂功能 planner → tdd-guide → code-reviewer RTK 减少输出
Bug 修复 tdd-guide → code-reviewer 并行 Agent 加速
架构决策 architect 多视角分析
安全改动 security-reviewer → code-reviewer 专项审查
构建失败 build-error-resolver RTK 过滤错误
代码维护 refactor-cleaner → doc-updater 定期执行

善用这些内置 Agent,可以让 Claude Code 从「聊天工具」变成真正的「AI 开发搭档」。

更多推荐