如何用好 Everything Claude Code8大内置Subagents触发时机与适用场景全解析【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-codeEverything Claude Code 是 Claude Code 的一套生产级 AI 辅助开发配置包内置 8 个可自动协作的 Subagents子代理。本文逐一解析每个 agent 的触发时机、适用场景与能力边界帮助你在不同开发阶段快速选对AI 助手让 AI 辅助开发效率翻倍。什么是 Subagents先理解分工机制在 Everything Claude Code 中Subagents是存放在agents/目录下的专用 AI 角色定义文件。每个文件用一个 Markdown 描述一种专家它的职责、工作流程、输出格式和质量标准。主 AI 会根据任务上下文自动委派给最合适的子代理无需你手动指定。这套委派机制的官方规则定义在 rules/agents.md 中其中明确列出了各 agent 的何时使用对照表。 核心理念让写代码的 AI、审代码的 AI和测试的 AI各司其职就像真实团队的分工一样。8大Subagents速查表一张表看懂适用场景Subagent一句话定位典型触发时机定义文件planner功能规划专家实现复杂功能前planner.mdarchitect系统架构专家做架构决策时architect.mdtdd-guide测试驱动开发专家写新功能/修 Bug 时tdd-guide.mdcode-reviewer代码审查专家写完/改完代码后code-reviewer.mdsecurity-reviewer安全审计专家提交代码前security-reviewer.mde2e-runner端到端测试专家验证关键用户流程e2e-runner.mdrefactor-cleaner死代码清理专家代码库维护期refactor-cleaner.mddoc-updater文档同步专家功能变更后doc-updater.md规划类Agentplanner 与 architect 何时触发planner复杂功能与重构的总策划触发时机当你提出实现新功能、架构变更或复杂重构请求时planner 会被自动激活。适用场景 把一个模糊需求拆解成带文件路径、依赖关系和风险等级的实施步骤 识别功能依赖给出最优实施顺序 规划渐进式重构路径避免大爆炸式改动planner 的输出是一份结构化实施计划包含分阶段步骤、测试策略和成功标准适合在动手写代码前对齐预期。architect架构决策的军师触发时机规划新功能、重构大型系统或做技术选型时应主动PROACTIVELY启用。适用场景️ 新系统的整体架构设计与技术权衡分析️ 识别扩展性瓶颈、评估 10K→100 万用户的扩容路径️ 为重要决策生成 ADR架构决策记录留存为什么这么选两者区别planner 关注怎么分步做architect 关注应该怎么设计。大型功能建议先用 architect 定方案再用 planner 排步骤。质量类Agentcode-reviewer、security-reviewer、tdd-guidecode-reviewer写完代码的第一道门禁触发时机任何代码编写或修改完成后立即触发。它是 8 个 agent 中唯一标注MUST BE USED必须使用的角色——所有代码变更都应经过审查。适用场景 按严重 / 警告 / 建议三级输出审查意见并附具体修复示例 检查硬编码密钥、SQL 注入、XSS、输入校验缺失等高频问题 评估测试覆盖度与性能隐患如 O(n²) 算法、N1 查询它还会给出明确的审批结论✅ 通过 / ⚠️ 有警告可合并 / ❌ 存在严重问题需拦截。security-reviewer提交前的安全扫描仪触发时机编写涉及用户输入、身份认证、API 端点或敏感数据的代码后应主动启用生产事故、依赖出现已知 CVE 时需立即启用。适用场景️ 按 OWASP Top 10 逐类排查注入、认证缺陷、越权访问、不安全反序列化等️ 扫描硬编码密钥含 git 历史中的残留️ 输出结构化安全报告给出严重级别与风险等级与 code-reviewer 的分工code-reviewer 看质量安全security-reviewer 是纯安全深水区扫描处理涉及支付、鉴权、文件上传的代码时二者可叠加使用。tdd-guide测试先行纪律的教练触发时机开发新功能、修复 Bug 或重构代码时主动启用。适用场景 强制执行先写失败测试 → 最小实现 → 重构的 Red-Green-Refactor 循环 保证 80% 以上测试覆盖率覆盖空值、边界、异常路径 指导编写单元测试、集成测试与 E2E 测试的完整测试矩阵 简单说只要你开始写业务代码tdd-guide 就该在场它是测试不是可选项的纪律保障。测试类Agente2e-runner 关键流程守门人触发时机需要生成、维护或运行 Playwright 端到端测试时主动启用尤其是涉及认证、支付、核心交易等关键用户流程。适用场景 为登录、下单、搜索等用户旅程编写基于页面对象模型的 Playwright 测试 识别并隔离抖动flaky测试避免其污染 CI 流水线 管理测试产物失败截图、视频回放、Trace 调试文件 接入 CI/CD在 Pull Request 上自动执行并汇报结果适用边界e2e-runner 专注最后防线。琐碎 UI 细节优先用单元测试覆盖把 E2E 预算留给高风险主流程。维护类Agentrefactor-cleaner 与 doc-updaterrefactor-cleaner死代码清道夫触发时机项目进入维护期、需要移除未使用代码/重复代码/废弃依赖时启用。适用场景 并行运行 knip、depcheck、ts-prune 等工具定位死代码 按 SAFE / CAREFUL / RISKY 三级风险分批删除每批删除后跑测试并提交 生成 DELETION_LOG.md 删除台账全程可追溯、可回滚明确的不要使用场景来自其定义文件功能开发活跃期、生产部署前夕、代码库不稳定或缺乏测试覆盖时。doc-updater文档与代码的同步器触发时机新增重大功能、API 路由变更、依赖增减或架构变化后应更新文档小修小补则可选。适用场景 从代码结构自动生成 codemap前端/后端/数据库/集成模块的架构地图 刷新 README、使用指南并校验文档中引用的文件路径与链接真实有效 提取 JSDoc 注释生成 API 参考文档它强调文档必须源自代码避免文档与现实脱节比没有文档更糟的问题。实战指南一个完整开发流程中的 Agent 接力理解了触发时机后可以把 8 个 Subagents 串成一条流水线设计→ architect 确定方案复杂时配合 planner 出实施计划开发→ tdd-guide 监督测试先行写功能自检→ code-reviewer 审查所有改动必过门禁安全→ security-reviewer 深扫输入、鉴权与敏感数据验收→ e2e-runner 跑关键用户流程收尾→ refactor-cleaner 清理冗余 doc-updater 同步文档独立的任务如安全扫描 性能审查 类型检查可并行委派多个 agent规则文件 rules/agents.md 中也推荐使用并行执行以节省等待时间。常见问题 FAQQ每个 agent 都用最强模型会不会很慢A8 个 agent 均配置为 opus 模型见各文件 frontmatter换来的是更可靠的架构与审查判断它们只在被委派时介入不会拖慢日常对话。Qagent 定义文件能改吗A可以。每个 agents/ 下的 Markdown 都是纯文本定义你可以按团队规范补充项目专属检查项如 code-reviewer 中的项目特定规范章节就是为此预留的。Q这套 Subagents 和 skills、commands 是什么关系ASubagents 负责谁来干skills/ 目录存放怎么干的领域知识如 TDD 方法论、安全清单commands/ 提供/tdd、/plan、/e2e等快捷指令三者配合构成完整的 AI 辅助开发体系项目总览可参考 README.md。总结Everything Claude Code 的 8 大 Subagents 覆盖了从设计、开发、审查、安全到测试与文档维护的完整链路。记住一条原则即可规划交给 planner/architect质量交给三个审查类 agent收尾交给清理与文档 agent。把正确的任务委派给正确的AI 专家是这套配置包发挥最大价值的关键。【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
