🤖 Agents 详解

28 个专业子代理,每个都有明确的能力边界和工具权限

🟡 进阶级

什么是 Agents?

Agents 是处理特定任务的专家代理。它们具有以下特点:

  • 专业性:每个 Agent 只负责特定领域
  • 工具限制:只能使用被授权的工具
  • 可委派:主代理可以将任务委派给专业 Agent
  • 模型选择:不同 Agent 可以使用不同的模型(如 opus 用于深度分析)

Agent 文件格式

---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

You are a senior code reviewer...

开发类 Agents

📋
planner
功能实现规划,分解复杂任务,输出实现蓝图

model: opus

触发: /plan

🏗️
architect
系统架构设计,技术选型决策,模块划分

model: opus

🧪
tdd-guide
测试驱动开发指导,强制 RED-GREEN-REFACTOR 流程

常用

触发: /tdd

📝
doc-updater
文档同步更新,确保代码和文档一致

model: haiku

触发: /update-docs

📚
docs-lookup
文档和 API 查询,快速获取技术文档

model: haiku

🔄
refactor-cleaner
死代码清理,移除未使用的导入和函数

触发: /refactor-clean

审查类 Agents

🔍
code-reviewer
代码质量和安全审查,检查风格、性能、可维护性

常用

触发: /code-review

🔒
security-reviewer
安全漏洞检测,OWASP Top 10 检查,敏感信息扫描

重要

触发: /security-scan

🗄️
database-reviewer
数据库查询审查,SQL 性能优化,Supabase 专家

自动委派

构建修复 Agents

🛠️
build-error-resolver
通用构建错误修复,分析错误日志并提供解决方案

常用

触发: /build-fix

📦
cpp-build-resolver
C++ 构建错误修复,CMake、编译器错误

触发: /cpp-build

🐹
go-build-resolver
Go 构建错误修复,模块依赖问题

触发: /go-build

☕
java-build-resolver
Java 构建错误修复,Maven/Gradle 问题

触发: /gradle-build

🎯
kotlin-build-resolver
Kotlin 构建错误修复,Gradle/KMP 问题

触发: /kotlin-build

🦀
rust-build-resolver
Rust 构建错误修复,Cargo、借用检查问题

触发: /rust-build

🔥
pytorch-build-resolver
PyTorch/CUDA 训练错误修复,GPU 问题

语言专家 Agents

📘
typescript-reviewer
TypeScript/JavaScript 代码审查,类型安全,React/Vue/Next.js

常用

🐍
python-reviewer
Python 代码审查,PEP 8,类型提示,FastAPI/Django

触发: /python-review

🐹
go-reviewer
Go 代码审查,惯用写法,并发安全,性能优化

触发: /go-review

☕
java-reviewer
Java 代码审查,Spring Boot,JPA/Hibernate

触发: /java-review

🎯
kotlin-reviewer
Kotlin 代码审查,Android/KMP,协程

触发: /kotlin-review

🦀
rust-reviewer
Rust 代码审查,所有权,生命周期,unsafe 检查

触发: /rust-review

⚡
cpp-reviewer
C++ 代码审查,内存安全,现代 C++ 特性

触发: /cpp-review

🦋
flutter-reviewer
Flutter/Dart 代码审查,Widget 优化,状态管理

测试类 Agents

🎭
e2e-runner
Playwright E2E 测试,端到端测试生成和执行

常用

触发: /e2e

运营类 Agents

👔
chief-of-staff
通信协调,消息起草,邮件处理,对外沟通
🔄
loop-operator
自主循环执行,长时间任务监控

触发: /loop-start

⚡
harness-optimizer
Harness 配置优化,性能调优

如何使用 Agents

方式一:通过命令触发

# 触发 tdd-guide
/tdd 用户登录功能

# 触发 code-reviewer
/code-review

# 触发 build-error-resolver
/build-fix

方式二:直接请求

# 在对话中明确请求
"使用 python-reviewer 审查我的 FastAPI 代码"

"请 security-reviewer 检查这个接口的安全问题"

方式三:自动委派

某些 Agent 会被自动委派。例如,当你操作数据库相关代码时,database-reviewer 可能会被自动调用。

Agent 选择指南

我想... 使用这个 Agent
规划一个新功能 planner
设计系统架构 architect
测试驱动开发 tdd-guide
审查代码质量 code-reviewer
检查安全问题 security-reviewer
修复构建错误 build-error-resolver
运行 E2E 测试 e2e-runner
清理死代码 refactor-cleaner
更新文档 doc-updater
审查 Go 代码 go-reviewer
审查 Python 代码 python-reviewer
审查 TypeScript 代码 typescript-reviewer