Cherry Studio 中的 Claude Code Subagent 模板指南为代码库设计并行审查与分析子代理【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio导读在 Claude Code 的自动化体系中Subagent子代理是运行在独立上下文窗口中的专用 Claude 实例可并行执行审查、分析与生成任务。本指南基于 Cherry Studio 内置 Cherry 小助手中claude-automation-recommender技能所附的 subagent-templates.md 模板库系统梳理代码审查、安全审计、测试生成、API 文档、性能分析、UI 审查、依赖更新与迁移辅助 8 类子代理的适用场景、模型选型与工具授权策略并给出可落地的目录结构与速查表帮助你在自己的项目里快速搭建一套按需触发的子代理工作流。一、Subagent 是什么并行、隔离、专用的执行单元Subagent 是专门化的 Claude 实例与主会话相比具有三个核心特征并行运行多个子代理可同时启动互不阻塞适合把大量独立任务拆散并行处理独立上下文窗口每个子代理拥有自己的上下文不会污染主会话的历史也避免了单一上下文被海量文件撑爆独立工具权限每个子代理可以按需配置自己的工具集Read、Grep、Glob、Write、Bash 等精细控制它能做什么、不能做什么。原文明确指出Subagents are specialized Claude instances that run in parallel, each with their own context window and tool access. Theyre ideal for focused reviews, analysis, or generation tasks.因此子代理最擅长三类工作聚焦式审查review、定向分析analysis与批量生成generation。它们不是万能的——需要全局上下文连贯推进的任务如大型重构更适合主会话或按需 fork这点在模型选型一节会进一步展开。设计提示模板库中的角色是常见模式common patterns原文特别注明应根据代码库具体的审查与分析需求设计自定义子代理不要照搬。二、Code Review Agents代码审查类子代理模板2.1 code-reviewer大仓库并行代码质量检查适用场景代码规模大、变更频繁、团队希望统一审查口径。Recommend When何时推荐Detection检测信号Large codebase (500 files) 大型代码库超过 500 个文件File count 文件数量Frequent code changes 频繁代码变更Active development 活跃开发状态Team wants consistent review 团队需要一致的审查标准Quality focus 质量导向价值在你继续工作的同时子代理并行运行代码审查不占用主会话时间。模型sonnet质量/速度均衡。工具Read、Grep、Glob、Bash。这是最典型的并行审查场景文件超过 500 的仓库靠主会话逐个文件读必然低效而 code-reviewer 可以在独立上下文中并行扫描多个目录。2.2 security-reviewer安全专项代码审查适用场景涉及鉴权、支付、用户数据、密钥等安全敏感代码的仓库。Recommend WhenDetectionAuth code present 存在鉴权代码auth/、login、sessionpatternsPayment processing 支付处理stripe、payment、billingpatternsUser data handling 用户数据处理user、profile、piipatternsAPI keys in code 代码中的 API 密钥Environment variable patterns 环境变量模式价值发现 OWASP 漏洞、鉴权问题与数据泄露风险。模型sonnet。工具Read、Grep、Glob只读出于安全考虑。注意这里工具被刻意限制为只读集——安全审查本身不需要修改文件只读权限既满足分析需求又降低误改风险这是按任务收缩工具面的典型设计。三、Specialized Agents专项技能类子代理模板3.1 test-writer按项目约定生成测试适用场景测试覆盖不足、测试框架已配置的仓库。Recommend WhenDetectionLow test coverage 测试覆盖低Few test files vs source files 测试文件远少于源文件Test suite exists 已有测试套件tests/、__tests__/presentTesting framework configured 测试框架已配置jest、pytest、vitest in deps 依赖中出现价值生成的测试符合项目既有约定。模型sonnet。工具Read、Write、Grep、Glob相较审查类子代理增加了Write权限因为它的产出是测试文件。test-writer 是读源码 → 对齐项目测试风格 → 写测试的闭环其工具集从审查类的只读扩展为可写正好印证了工具授权应与任务产物相匹配的原则。3.2 api-documenterAPI 文档自动生成适用场景存在 REST 端点、GraphQL schema 或 OpenAPI 定义但文档缺失的项目。Recommend WhenDetectionREST endpointsExpress routes、FastAPI pathsGraphQL schema.graphqlfilesOpenAPI existsopenapi.yaml、swagger.jsonUndocumented APIsRoutes without docs 无文档的路由价值生成 OpenAPI 规范与端点文档。模型sonnet。工具Read、Write、Grep、Glob。对于 API 项目api-documenter 可以批量读取路由定义并输出结构化的 OpenAPI YAML——这与 Cherry Studio 仓库中 resources/builtin-agents/cherry-assistant/.claude/skills/claude-automation-recommender/SKILL.md 的 Phase 2-D 推荐逻辑API project → api-documenter - OpenAPI generation完全对应。3.3 performance-analyzer性能瓶颈定位适用场景数据库查询密集、高流量路径、用户反馈卡顿、存在复杂算法的代码。Recommend WhenDetectionDatabase queries 数据库查询ORM usage、raw SQLHigh-traffic code 高流量代码API endpoints、hot paths 热点路径Performance complaints 性能投诉User reports slownessComplex algorithms 复杂算法Nested loops、recursion 嵌套循环、递归价值发现 N1 查询、O(n²) 算法与内存泄漏。模型sonnet。工具Read、Grep、Glob、Bash需要 Bash 执行分析脚本或 profiling 命令。3.4 ui-reviewer前端可访问性与 UX 审查适用场景存在 React/Vue/Angular 等前端框架、组件库或面向用户界面的仓库。Recommend WhenDetectionReact/Vue/AngularFrontend framework detected 检测到前端框架Component library 组件库components/directoryUser-facing UI 面向用户的界面Not just API project 不仅是纯 API 项目价值发现可访问性问题、UX 问题与响应式设计缺口。模型sonnet。工具Read、Grep、Glob。以 Cherry Studio 仓库为例其渲染层src/renderer/components/下包含数百个组件文件属于典型的组件库形态ui-reviewer 正是此类前端重型仓库的推荐角色。四、Utility Agents工具类子代理模板4.1 dependency-updater安全地更新依赖适用场景依赖过期、存在安全公告、大版本落后。Recommend WhenDetectionOutdated deps 依赖过期npm outdatedhas resultsSecurity advisories 安全公告npm auditwarningsMajor version behind 大版本落后Significant version gaps 明显版本差距价值增量更新依赖并伴随测试验证避免一次性大版本升级带来的连锁破坏。模型sonnet。工具Read、Write、Bash、Grep。4.2 migration-helper框架/版本迁移适用场景需要大版本升级、出现弃用警告、计划架构重构。Recommend WhenDetectionMajor upgrade needed 需要大版本升级Framework version very old 框架版本很旧Breaking changes coming 破坏性变更将至Deprecation warnings 弃用警告Refactoring planned 计划重构Architectural changes 架构变更价值增量规划并执行迁移。模型opus需要复杂推理。工具Read、Write、Grep、Glob、Bash全量工具集。migration-helper 是唯一默认推荐opus模型的模板——因为迁移涉及跨文件的行为推演与破坏性变更评估推理复杂度显著高于常规审查任务。这也呼应了模型选型指南中opus 面向复杂迁移与架构的定位。五、快速参考检测信号 → 子代理推荐以下速查表覆盖上述全部模板是 claude-automation-recommender 在扫描完代码库后直接使用的映射逻辑参见 SKILL.md 的 Phase 2-D 子代理推荐表If You See检测到Recommend Subagent推荐子代理Large codebase 大型代码库code-reviewerAuth/payment code 鉴权/支付代码security-reviewerFew tests 测试稀少test-writerAPI routes API 路由api-documenterDatabase heavy 数据库密集performance-analyzerFrontend components 前端组件ui-reviewerOutdated packages 依赖过期dependency-updaterOld framework version 框架版本过旧migration-helper实际推荐时的输出纪律来自 SKILL.md 输出准则每个类别只推荐最有价值的 12 个避免淹没用户若用户点名要某一类则聚焦该类并给出 35 个选项。六、子代理的放置位置.claude/agents/ 目录子代理文件统一放在项目根目录的.claude/agents/下每个子代理一个 Markdown 文件.claude/ └── agents/ ├── code-reviewer.md ├── security-reviewer.md └── test-writer.mdClaude Code 会扫描该目录并自动注册这些子代理文件名即子代理名。需要说明的是该目录与.claude/skills/、.claude/settings.jsonhooks 配置并行存在共同构成项目的自动化配置面。以 Cherry Studio 自身的 Cherry 小助手为例其内置 Agent 配置 resources/builtin-agents/cherry-assistant/agent.json 展示了类似的声明式注册思路type: claude-code声明运行形态skills数组挂载 7 个内置技能含claude-automation-recommender并通过accessible_paths: [#{PROJECT_ROOT}]限定可访问路径。这意味着子代理/技能的注册既可以走.claude/目录文件约定也可以在 Cherry Studio 的内置 Agent 清单中显式声明两种方式最终都由主进程侧的 Agent 供给与能力校验逻辑接管可参考 src/main/ai/agents/builtin/BuiltinAgentProvisioner.ts 与 src/main/ai/agents/builtin/builtinAgentCapabilities.ts 的实现与测试。七、模型选型指南haiku / sonnet / opusModel 模型Best For 最适合Trade-off 权衡haikuSimple, repetitive checks 简单重复性检查Fast, cheap, less thorough 快、便宜、不够彻底sonnetMost review/analysis tasks 多数审查/分析任务Balanced 均衡推荐的默认选择opusComplex migrations, architecture 复杂迁移、架构设计Thorough, slower, more expensive 彻底、慢、成本高落地建议模板库中除 migration-helper 外几乎全部默认 sonnet因为审查类任务吃的是充分理解代码 稳定输出结论的能力sonnet 在质量与速度/成本之间最均衡批量跑简单检查时降级 haiku 可显著降低成本涉及迁移规划、架构级判断时再上调 opus。八、工具访问指南按任务收缩权限面Access Level 访问级别Tools 工具Use Case 适用场景Read-only 只读Read, Grep, GlobReviews, analysis 审查、分析Writing 可写 WriteCode generation, docs 代码生成、文档Full 完整 BashMigrations, testing 迁移、测试设计要点审查类code-reviewer、security-reviewer、ui-reviewer、performance-analyzer 的静态部分尽量停留在只读级别安全审查尤其如此生成类test-writer、api-documenter、dependency-updater需要 Write 落盘产物执行类migration-helper、performance-analyzer 的动态分析才开放 Bash用于运行测试、profiling 与迁移命令。这一工具面随任务产物伸缩的原则与 SKILL.md 中 hooks 权限配置.claude/settings.json的permissions.allow白名单一脉相承可配合使用。九、在 Cherry Studio 中的实际应用路径如果你是 Cherry Studio 用户希望让自己的项目获得这类自动化推荐在 Cherry Studio 中唤起内置 Cherry 小助手其能力声明见 resources/builtin-agents/cherry-assistant/agent.jsonclaude-automation-recommender技能已默认挂载让助手扫描你的代码库它会按 SKILL.md 的 Phase 2-D 逻辑结合本文的检测信号表输出 12 个最值得先建的子代理按其建议在项目.claude/agents/下创建对应 Markdown 文件并用上面的模型选型与工具访问指南为每个子代理定级。十、模板使用要点回顾按需组合8 个模板不是必装清单而是覆盖审查 / 专项 / 工具三类诉求的起点应根据代码库实际信号挑选权限最小化默认从只读起步只有任务确实需要写文件或执行命令时才逐级放开模型梯度化默认 sonnet简单批量检查用 haiku复杂迁移用 opus检测驱动用检测信号表第五节把代码库特征映射到子代理这一映射逻辑同时也是 claude-automation-recommender 技能与 hooks-patterns、mcp-servers 等其他参考文档配合工作的基础。【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Cherry Studio 中的 Claude Code Subagent 模板指南：为代码库设计并行审查与分析子代理
Cherry Studio 中的 Claude Code Subagent 模板指南为代码库设计并行审查与分析子代理【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio导读在 Claude Code 的自动化体系中Subagent子代理是运行在独立上下文窗口中的专用 Claude 实例可并行执行审查、分析与生成任务。本指南基于 Cherry Studio 内置 Cherry 小助手中claude-automation-recommender技能所附的 subagent-templates.md 模板库系统梳理代码审查、安全审计、测试生成、API 文档、性能分析、UI 审查、依赖更新与迁移辅助 8 类子代理的适用场景、模型选型与工具授权策略并给出可落地的目录结构与速查表帮助你在自己的项目里快速搭建一套按需触发的子代理工作流。一、Subagent 是什么并行、隔离、专用的执行单元Subagent 是专门化的 Claude 实例与主会话相比具有三个核心特征并行运行多个子代理可同时启动互不阻塞适合把大量独立任务拆散并行处理独立上下文窗口每个子代理拥有自己的上下文不会污染主会话的历史也避免了单一上下文被海量文件撑爆独立工具权限每个子代理可以按需配置自己的工具集Read、Grep、Glob、Write、Bash 等精细控制它能做什么、不能做什么。原文明确指出Subagents are specialized Claude instances that run in parallel, each with their own context window and tool access. Theyre ideal for focused reviews, analysis, or generation tasks.因此子代理最擅长三类工作聚焦式审查review、定向分析analysis与批量生成generation。它们不是万能的——需要全局上下文连贯推进的任务如大型重构更适合主会话或按需 fork这点在模型选型一节会进一步展开。设计提示模板库中的角色是常见模式common patterns原文特别注明应根据代码库具体的审查与分析需求设计自定义子代理不要照搬。二、Code Review Agents代码审查类子代理模板2.1 code-reviewer大仓库并行代码质量检查适用场景代码规模大、变更频繁、团队希望统一审查口径。Recommend When何时推荐Detection检测信号Large codebase (500 files) 大型代码库超过 500 个文件File count 文件数量Frequent code changes 频繁代码变更Active development 活跃开发状态Team wants consistent review 团队需要一致的审查标准Quality focus 质量导向价值在你继续工作的同时子代理并行运行代码审查不占用主会话时间。模型sonnet质量/速度均衡。工具Read、Grep、Glob、Bash。这是最典型的并行审查场景文件超过 500 的仓库靠主会话逐个文件读必然低效而 code-reviewer 可以在独立上下文中并行扫描多个目录。2.2 security-reviewer安全专项代码审查适用场景涉及鉴权、支付、用户数据、密钥等安全敏感代码的仓库。Recommend WhenDetectionAuth code present 存在鉴权代码auth/、login、sessionpatternsPayment processing 支付处理stripe、payment、billingpatternsUser data handling 用户数据处理user、profile、piipatternsAPI keys in code 代码中的 API 密钥Environment variable patterns 环境变量模式价值发现 OWASP 漏洞、鉴权问题与数据泄露风险。模型sonnet。工具Read、Grep、Glob只读出于安全考虑。注意这里工具被刻意限制为只读集——安全审查本身不需要修改文件只读权限既满足分析需求又降低误改风险这是按任务收缩工具面的典型设计。三、Specialized Agents专项技能类子代理模板3.1 test-writer按项目约定生成测试适用场景测试覆盖不足、测试框架已配置的仓库。Recommend WhenDetectionLow test coverage 测试覆盖低Few test files vs source files 测试文件远少于源文件Test suite exists 已有测试套件tests/、__tests__/presentTesting framework configured 测试框架已配置jest、pytest、vitest in deps 依赖中出现价值生成的测试符合项目既有约定。模型sonnet。工具Read、Write、Grep、Glob相较审查类子代理增加了Write权限因为它的产出是测试文件。test-writer 是读源码 → 对齐项目测试风格 → 写测试的闭环其工具集从审查类的只读扩展为可写正好印证了工具授权应与任务产物相匹配的原则。3.2 api-documenterAPI 文档自动生成适用场景存在 REST 端点、GraphQL schema 或 OpenAPI 定义但文档缺失的项目。Recommend WhenDetectionREST endpointsExpress routes、FastAPI pathsGraphQL schema.graphqlfilesOpenAPI existsopenapi.yaml、swagger.jsonUndocumented APIsRoutes without docs 无文档的路由价值生成 OpenAPI 规范与端点文档。模型sonnet。工具Read、Write、Grep、Glob。对于 API 项目api-documenter 可以批量读取路由定义并输出结构化的 OpenAPI YAML——这与 Cherry Studio 仓库中 resources/builtin-agents/cherry-assistant/.claude/skills/claude-automation-recommender/SKILL.md 的 Phase 2-D 推荐逻辑API project → api-documenter - OpenAPI generation完全对应。3.3 performance-analyzer性能瓶颈定位适用场景数据库查询密集、高流量路径、用户反馈卡顿、存在复杂算法的代码。Recommend WhenDetectionDatabase queries 数据库查询ORM usage、raw SQLHigh-traffic code 高流量代码API endpoints、hot paths 热点路径Performance complaints 性能投诉User reports slownessComplex algorithms 复杂算法Nested loops、recursion 嵌套循环、递归价值发现 N1 查询、O(n²) 算法与内存泄漏。模型sonnet。工具Read、Grep、Glob、Bash需要 Bash 执行分析脚本或 profiling 命令。3.4 ui-reviewer前端可访问性与 UX 审查适用场景存在 React/Vue/Angular 等前端框架、组件库或面向用户界面的仓库。Recommend WhenDetectionReact/Vue/AngularFrontend framework detected 检测到前端框架Component library 组件库components/directoryUser-facing UI 面向用户的界面Not just API project 不仅是纯 API 项目价值发现可访问性问题、UX 问题与响应式设计缺口。模型sonnet。工具Read、Grep、Glob。以 Cherry Studio 仓库为例其渲染层src/renderer/components/下包含数百个组件文件属于典型的组件库形态ui-reviewer 正是此类前端重型仓库的推荐角色。四、Utility Agents工具类子代理模板4.1 dependency-updater安全地更新依赖适用场景依赖过期、存在安全公告、大版本落后。Recommend WhenDetectionOutdated deps 依赖过期npm outdatedhas resultsSecurity advisories 安全公告npm auditwarningsMajor version behind 大版本落后Significant version gaps 明显版本差距价值增量更新依赖并伴随测试验证避免一次性大版本升级带来的连锁破坏。模型sonnet。工具Read、Write、Bash、Grep。4.2 migration-helper框架/版本迁移适用场景需要大版本升级、出现弃用警告、计划架构重构。Recommend WhenDetectionMajor upgrade needed 需要大版本升级Framework version very old 框架版本很旧Breaking changes coming 破坏性变更将至Deprecation warnings 弃用警告Refactoring planned 计划重构Architectural changes 架构变更价值增量规划并执行迁移。模型opus需要复杂推理。工具Read、Write、Grep、Glob、Bash全量工具集。migration-helper 是唯一默认推荐opus模型的模板——因为迁移涉及跨文件的行为推演与破坏性变更评估推理复杂度显著高于常规审查任务。这也呼应了模型选型指南中opus 面向复杂迁移与架构的定位。五、快速参考检测信号 → 子代理推荐以下速查表覆盖上述全部模板是 claude-automation-recommender 在扫描完代码库后直接使用的映射逻辑参见 SKILL.md 的 Phase 2-D 子代理推荐表If You See检测到Recommend Subagent推荐子代理Large codebase 大型代码库code-reviewerAuth/payment code 鉴权/支付代码security-reviewerFew tests 测试稀少test-writerAPI routes API 路由api-documenterDatabase heavy 数据库密集performance-analyzerFrontend components 前端组件ui-reviewerOutdated packages 依赖过期dependency-updaterOld framework version 框架版本过旧migration-helper实际推荐时的输出纪律来自 SKILL.md 输出准则每个类别只推荐最有价值的 12 个避免淹没用户若用户点名要某一类则聚焦该类并给出 35 个选项。六、子代理的放置位置.claude/agents/ 目录子代理文件统一放在项目根目录的.claude/agents/下每个子代理一个 Markdown 文件.claude/ └── agents/ ├── code-reviewer.md ├── security-reviewer.md └── test-writer.mdClaude Code 会扫描该目录并自动注册这些子代理文件名即子代理名。需要说明的是该目录与.claude/skills/、.claude/settings.jsonhooks 配置并行存在共同构成项目的自动化配置面。以 Cherry Studio 自身的 Cherry 小助手为例其内置 Agent 配置 resources/builtin-agents/cherry-assistant/agent.json 展示了类似的声明式注册思路type: claude-code声明运行形态skills数组挂载 7 个内置技能含claude-automation-recommender并通过accessible_paths: [#{PROJECT_ROOT}]限定可访问路径。这意味着子代理/技能的注册既可以走.claude/目录文件约定也可以在 Cherry Studio 的内置 Agent 清单中显式声明两种方式最终都由主进程侧的 Agent 供给与能力校验逻辑接管可参考 src/main/ai/agents/builtin/BuiltinAgentProvisioner.ts 与 src/main/ai/agents/builtin/builtinAgentCapabilities.ts 的实现与测试。七、模型选型指南haiku / sonnet / opusModel 模型Best For 最适合Trade-off 权衡haikuSimple, repetitive checks 简单重复性检查Fast, cheap, less thorough 快、便宜、不够彻底sonnetMost review/analysis tasks 多数审查/分析任务Balanced 均衡推荐的默认选择opusComplex migrations, architecture 复杂迁移、架构设计Thorough, slower, more expensive 彻底、慢、成本高落地建议模板库中除 migration-helper 外几乎全部默认 sonnet因为审查类任务吃的是充分理解代码 稳定输出结论的能力sonnet 在质量与速度/成本之间最均衡批量跑简单检查时降级 haiku 可显著降低成本涉及迁移规划、架构级判断时再上调 opus。八、工具访问指南按任务收缩权限面Access Level 访问级别Tools 工具Use Case 适用场景Read-only 只读Read, Grep, GlobReviews, analysis 审查、分析Writing 可写 WriteCode generation, docs 代码生成、文档Full 完整 BashMigrations, testing 迁移、测试设计要点审查类code-reviewer、security-reviewer、ui-reviewer、performance-analyzer 的静态部分尽量停留在只读级别安全审查尤其如此生成类test-writer、api-documenter、dependency-updater需要 Write 落盘产物执行类migration-helper、performance-analyzer 的动态分析才开放 Bash用于运行测试、profiling 与迁移命令。这一工具面随任务产物伸缩的原则与 SKILL.md 中 hooks 权限配置.claude/settings.json的permissions.allow白名单一脉相承可配合使用。九、在 Cherry Studio 中的实际应用路径如果你是 Cherry Studio 用户希望让自己的项目获得这类自动化推荐在 Cherry Studio 中唤起内置 Cherry 小助手其能力声明见 resources/builtin-agents/cherry-assistant/agent.jsonclaude-automation-recommender技能已默认挂载让助手扫描你的代码库它会按 SKILL.md 的 Phase 2-D 逻辑结合本文的检测信号表输出 12 个最值得先建的子代理按其建议在项目.claude/agents/下创建对应 Markdown 文件并用上面的模型选型与工具访问指南为每个子代理定级。十、模板使用要点回顾按需组合8 个模板不是必装清单而是覆盖审查 / 专项 / 工具三类诉求的起点应根据代码库实际信号挑选权限最小化默认从只读起步只有任务确实需要写文件或执行命令时才逐级放开模型梯度化默认 sonnet简单批量检查用 haiku复杂迁移用 opus检测驱动用检测信号表第五节把代码库特征映射到子代理这一映射逻辑同时也是 claude-automation-recommender 技能与 hooks-patterns、mcp-servers 等其他参考文档配合工作的基础。【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考