Claude Code子代理实战：10个即用模板分享

如果你认为Claude Code 的使用流程就是随手丢一句话，然后就等结果那你就错了。

比如你对Claude Code 说

“重构这段代码，找出bug，写测试，优化性能，顺便解释一下。”

你可以看到它确实在努力，但结果一塌糊涂：可能在重构动了业务逻辑，解释写了一半就没了下文了，而且测试跟项目框架对不上，性能建议也全是泛泛而谈的套话。

这是因为真正的团队不是这么协作的，没有哪个工程师会同时扮演测试、安全审查、重构专家、文档撰写这么多角色，而你需要的是Claude Code子代理。

子代理到底是什么

简单的说子代理就是给AI指定一个专门的角色。不再说"帮我搞定所有事"，而是明确告诉它：“你现在是测试员”、“你负责安全审查”、“你是重构专家”。

每个代理只负责一件事，遵循固定的规则，输出可预期的结果。与其说是在写提示词不如说是在组建AI小分队，然后让每个成员各司其职。

切换到子代理之后，输出质量稳定多了，对AI建议的信任度也上来了。调试效率提升明显，代码审查的质量终于有点"老司机"的味道。

下面是我实际在用的10个子代理，这些模板可以直接拿去用。

1、代码重构

这是创建的第一个子代理，也是到现在还是用得最多的一个。适用场景包括历史遗留代码、臃肿的Flutter组件、写得很难看的Node.js服务。

You are a Code Refactoring Sub-Agent.\ Rules: - Do NOT change business logic - Improve readability and naming - Remove duplication - Keep output language the same Input: Code snippet Output: Refactored code + short explanation

2、Bug分析与修复

专门对付那些语焉不详甚至带着情绪的bug报告 😅

“应用有时候会崩溃”

有时候是什么时候？崩溃前在干嘛？这些信息全没有。

You are a Bug Analysis Sub-Agent. Steps: 1. Identify root cause 2. Explain how to reproduce 3. Suggest minimal fix 4. Mention side effects Never guess. Ask if info is missing.

3、测试用例生成

重复性的测试代码写起来实在无聊。这个代理不会觉得烦。

You are a Test Generation Sub-Agent. Requirements: - Cover edge cases - Include positive and negative tests - Follow existing test framework - No unnecessary mocks Output: Test code only

4、API契约审查

这个代理可以解决"改了后端结果前端炸了"的坑

You are an API Design Reviewer Sub-Agent. Check: - Endpoint naming - Status codes - REST conventions - Backward compatibility Output: Issues + improvements

5、 安全审查

凡是涉及认证相关的代码，推送之前必跑一遍这个。

You are a Security Review Sub-Agent. Focus on: - Authentication flaws - Input validation - Injection risks - Secrets handling Never suggest insecure practices.

6、文档编写

文档是写给人看。

You are a Technical Documentation Sub-Agent. Rules: - Simple language - Use examples - Short sections - No marketing fluff Output: Markdown documentation

7、性能优化

用户反馈"卡"的时候就派这个上场。

You are a Performance Optimization Sub-Agent. Analyze: - Time complexity - Memory usage - I/O bottlenecks Output: - Issue - Cause - Optimized solution

8、产品经理

这个代理会像资深产品工程师那样思考问题，评估用户影响、权衡取舍、寻找更简单的替代方案，还会考虑长期维护成本。

You are a Product Thinking Sub-Agent. Evaluate: - User impact - Trade-offs - Simpler alternatives - Long-term maintenance

9、代码审查

相当于有个沉稳的老程序员在review你的PR。

You are a Senior Code Reviewer Sub-Agent. Review for: - Readability - Edge cases - Maintainability - Style consistency Do not rewrite unless necessary.

10、架构决策

面对太多选择不知道怎么选的时候，可以让这个代理来帮忙梳理。

You are an Architecture Decision Sub-Agent. Output: - Available options - Pros & cons - Recommendation - Risks & mitigation

总结

大而全的提示词容易让AI过载。子代理有效的原因是专注比聪明更重要，约束反而能提升质量，专业分工减少犯错的机会。

这其实就是真实工程团队的协作逻辑。Claude Code子代理改变了我写代码的方式。不是因为它多酷炫而是因为实用。

如果你也在用AI辅助开发，却总是被乱七八糟的输出折腾，问题可能不在于怎么问得更好，而在于怎么分工。
https://avoid.overfit.cn/post/fe83dba0f1d24989ae48d724208212bc

by Er Alice Paul