Claude Code 子代理集合
为 Claude Code 提供 33 个专业子代理，覆盖全栈开发各环节，实现智能自动委派和多代理协同。
证据显示：README 建议将代理文件复制到 ~/.claude/agents/，并配置多个 MCP 服务器（包括 magic 需要 API 密钥），这些操作需要用户手动执行，且未提供自动执行或权限提升的说明。未发现恶意代码或凭证窃取迹象。扣分原因：未明确说明代理所需的最小权限范围，未提供用户确认机制，数据流不透明，敏感数据处理未提及，依赖安全性未评估，外部影响未明确，回滚机制未提供，来源归属仅基于 README 中的链接。
证据显示：README 提供了结构化的代理格式和一致的命名约定，代理文件按类别组织，内部一致性较好。扣分原因：依赖的 MCP 服务器（如 magic、context7）需要外部服务，其可用性未验证；未提供失败消息或错误处理指南。
证据显示：README 明确了目标受众（Claude Code 用户）和多种使用场景（自动调用、显式调用、混合调用），并提供了代理能力边界（如“何时使用哪个代理”表格）。扣分原因：触发精度依赖描述文本，未提供精确的触发条件；环境适配仅针对 Claude Code，未说明其他环境。
证据显示：README 提供了清晰的信息架构（按类别组织代理）、安装说明（手动和快速安装）、命名约定（kebab-case）、示例和 FAQ（使用示例和故障排除）。扣分原因：已知局限性仅提及 token 开销，未全面说明；版本控制仅通过 git 暗示，无显式版本号或变更日志；维护责任未明确。
证据显示：README 提供了丰富的使用示例和输出格式说明，代理设计用于提高开发效率，边际价值在于提供专业化的子代理。扣分原因：成本效益未量化，仅提及 token 开销，未提供实际性能数据。
证据显示：README 中的声明（如“33 个代理”）与文件列表一致，但未提供验证方法。扣分原因：声明缺乏可追溯性，未提供交叉验证来源，事实与推断未明确区分。
- 配置 MCP 服务器（如 magic）需要 API 密钥，请确保密钥安全，不要提交到公共仓库。
- 安装说明建议将代理文件复制到全局目录，可能与其他工具冲突，请谨慎操作。
- 代理的自动调用依赖描述文本，可能产生意外选择，建议在关键任务中显式指定代理。
这个 Agent 能做什么，适合哪些场景？
这是一个专门为 Claude Code 设计的子代理集合，包含 33 个专业化的 AI 子代理，覆盖软件开发全生命周期。每个子代理以 Markdown 文件形式存储在 agents/ 目录下，通过前端的描述字段实现上下文感知的自动调用。安装后，Claude Code 会根据任务上下文自动委派给最合适的子代理，例如 backend-architect、frontend-developer、security-auditor 等。这些子代理遵循标准化格式，包含角色定义、专业知识、关键能力和系统提示词，确保行为一致和可预测。项目还提供 agent-organizer 作为元编排器，用于复杂项目的多代理团队组装和工作流管理。用户可以通过自然语言指令直接指定要使用的子代理，也可以依赖 Claude Code 自动选择。深入的应用示例展示了多代理协作的完整流程，包括 token 消耗、时间线以及最终交付物。
这个仓库为 Claude Code 定义了一组指令文件（Markdown 格式），每个文件代表一个专业子代理，如 backend-architect、code-reviewer、test-automator 等。当用户向 Claude Code 提出请求时，Claude Code 会根据请求的上下文（如关键词、文件类型、任务类型）自动选择并加载相应的子代理指令，从而让 AI 采用特定领域的专业知识。子代理通过前端的 description 字段来触发，其中描述了其适用场景。用户也可以显式地通过自然语言调用，例如“使用 code-reviewer 检查我的代码”。对于复杂项目，agent-organizer 可以分析项目需求、组建子代理团队、编排多阶段工作流，并在质量门控处进行验证。子代理基于 MCP 服务器（如 sequential-thinking、context7）来增强推理和上下文获取，但这些是可选的。输出是遵循子代理指令执行的代码、文档或分析结果，直接集成到 Claude Code 的开发环境中。
- 全栈开发者：需要快速实现一个新功能，希望自动获得前端、后端和测试的协调，例如实现用户认证时自动触发 backend-architect、security-auditor 和 test-automator。
- 代码审查者：在合并代码前，希望使用专门的 code-reviewer 和 security-auditor 对拉取请求进行质量审查。
- 后端架构师：在规划微服务架构时，希望通过 backend-architect 设计 RESTful API 和数据库模式，并让 architect-reviewer 保持架构一致性。
- 性能优化工程师：当遇到性能瓶颈时，使用 performance-engineer 分析瓶颈、实施缓存策略，并用 database-optimizer 优化慢查询。
- 故障排查人员：在生产环境出现问题时，使用 devops-incident-responder 分析日志和部署失败，同时用 incident-responder 处理紧急事故。
- 数据科学家：进行数据分析时，通过 data-scientist 处理 SQL 查询和 BigQuery 操作，通过 ai-engineer 搭建 LLM 应用和 RAG 系统。
这个 Agent 有哪些优点和局限？
- 覆盖广泛的开发领域，提供 33 个专业子代理，从前端到安全审查。
- 自主编排能力：Claude Code 自动委派，加上 agent-organizer 支持复杂多代理工作流。
- 每个子代理有明确的触发条件，减少误用，提高效率。
- 项目包含实际示例，展示 token 消耗、时间线和交付物，帮助用户预估成本。
- 仅适用于 Claude Code；无法直接用于其他 AI 工具或 API。
- 需要一定的 Claude Code 使用经验来有效管理多代理协作。
- 部分功能依赖可选 MCP 服务器，配置复杂，未配置时功能受限。
- 多代理工作流可能消耗大量 token（如示例中 850K tokens），成本较高。
- 示例中声称的测试覆盖率和 token 消耗可能被夸大，实际效果需验证。
如何安装或部署这个 Agent？
- 确保已安装 Claude Code。
- 将仓库克隆到 ~/.claude/agents/ 目录：
cd ~/.claude
git clone https://github.com/lst97/claude-code-sub-agents.git- 或者，手动复制单个 agent 文件：
mkdir -p ~/.claude/agents/lst97
cp /path/to/agents/*.md ~/.claude/agents/lst97- 验证安装：
ls ~/.claude/agents/lst97/*.md在 Claude Code 中运行“列出所有可用的子代理”来检查。
- 如需完整性能，在全局配置文件 ~/.claude.json 中配置 MCP 服务器，例如 sequential-thinking 和 context7。
如何使用这个 Agent？
安装后，子代理会在 Claude Code 中自动可用。你可以使用自然语言明确指定子代理，例如“使用 code-reviewer 审查最近的更改”，或者“让 security-auditor 扫描漏洞”。也可以依赖自动委派，Claude Code 会根据上下文自动选择。对于复杂项目，可将 CLAUDE.md 复制到项目根目录以启用 agent-organizer 调度，然后通过简单指令如“实现用户认证”来触发多代理编排。查看示例了解典型工作流和资源消耗。
这个 Agent 与同类方案有什么区别？
该仓库未提及具体竞争对手，但可与其他 Claude Code 子代理集合（如 wshobson/agents）相比，后者是脚手架的来源。