告别混乱 Prompt:Claude Code 子代理的正确打开方式

告别无效 Prompt!掌握 Claude Code 子代理的正确用法,提升代码开发效率。

原文标题:别再乱喂 prompt 了!Claude Code 这么用才对

原文作者:数据派THU

冷月清谈:

本文介绍了 Claude Code 子代理的概念和优势,指出传统“all-in-one”的 Prompt 方式在代码开发中效果不佳。子代理的核心在于角色划分和专业分工,通过为 AI 设定明确的角色(如测试员、安全审查员等),让其专注于特定任务,从而提高输出质量和效率。文章分享了作者常用的10个 Claude Code 子代理模板,涵盖代码重构、Bug 分析、测试用例生成、API 契约审查、安全审查、文档编写、性能优化、产品经理、代码审查和架构决策等多个方面,并强调了 专注、约束和专业分工对于提升 AI 辅助开发效果的重要性。

怜星夜思:

1、除了文中提到的10个子代理,你觉得在实际开发中,还有哪些角色适合用 Claude Code 子代理来实现?可以结合你实际遇到的痛点来谈谈。
2、文章强调了子代理的“约束”作用,你认为在使用 Claude Code 子代理时,除了文中提到的 Rules 和 Requirements,还有哪些需要注意的约束条件?
3、文章提到了使用 Claude Code 子代理可以模拟团队协作,你认为这种方式和真实的团队协作相比,有哪些优势和不足?

原文内容

图片
来源:DeepHub IMBA
本文约1200字,建议阅读5分钟
本文介绍了 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辅助开发,却总是被乱七八糟的输出折腾,问题可能不在于怎么问得更好,而在于怎么分工。


编辑:于腾凯

校对:杨学俊



关于我们

数据派THU作为数据科学类公众号,背靠清华大学大数据研究中心,分享前沿数据科学与大数据技术创新研究动态、持续传播数据科学知识,努力建设数据人才聚集平台、打造中国大数据最强集团军。




新浪微博:@数据派THU

微信视频号:数据派THU

今日头条:数据派THU

我觉得最大的不足是缺乏“人情味”。团队协作不仅仅是完成任务,更重要的是建立信任和友谊。AI虽然可以模拟专业技能,但无法取代人与人之间的情感交流。长时间和AI一起工作可能会让人感到孤独和压抑。所以要合理安排工作,多和同事交流。

我想到的是“前端组件库维护者”子代理。现在前端框架更新太快了,组件库经常需要升级或者重构。如果能有一个AI专门负责把旧组件迁移到新版本,或者根据设计稿自动生成组件,那简直是解放生产力!

优势很明显啊,效率高!不用开会讨论,不用等待其他人的反馈,随时随地都可以得到AI的“专业”意见。而且AI不会有情绪,不会争吵,永远保持客观中立。适合快速原型开发或者解决一些重复性的工作。

要确保提示词的“可追溯性”。每次使用子代理时,都应该记录下使用的 Prompt、输入内容和输出结果。这样方便以后review和调试,也能更好地了解AI的能力边界。可以考虑用版本控制系统来管理这些提示词。

不足也很明显,缺乏创造性和灵活性。AI只能按照预设的规则和知识库来工作,很难提出颠覆性的想法或者解决未知的难题。而且AI无法理解人类的情感和意图,可能会造成沟通上的误解。所以关键还是要人来把控方向。

我觉得“安全红线”约束很重要。尤其是在使用安全审查子代理时,一定要明确告知AI哪些行为是绝对禁止的,比如不能泄露敏感信息、不能生成恶意代码等。最好能定期对AI进行安全测试,确保它不会被恶意利用。有点像给AI立规矩,避免它跑偏。

除了文中的例子,我觉得可以增加一个“国际化/本地化(i18n/l10n)专家”子代理。现在很多项目都需要支持多语言,让AI来检查和优化文本资源、生成不同语言版本的代码可以节省不少时间,尤其是在处理复杂的复数形式和日期格式时。

作为一个后端,我希望能有一个“数据库 Schema 设计师”子代理。每次设计数据库表结构都感觉很头疼,要考虑性能、扩展性、还要兼顾各种约束。如果能把业务需求喂给AI,让它自动生成优化的 Schema,那就太棒了!最好还能自动生成 migration 脚本。