Claude Code 内置 Agent 技能与工作流实战指南
·
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 开发搭档」。
更多推荐

所有评论(0)