掌握Claude Code Subagents：从"努力工作"到"聪明工作"的跨越

佛喜酱的AI实践
153 阅读8分钟

每个开发者都经历过：每天重复着类似的需求对齐、代码开发、bug修复、测试流程，手动处理琐碎的任务。这些重复性工作不仅浪费时间，还容易出错。难道我们注定要被困在重复劳动中吗？最近一次使用Claude Code Subagents的经历让我看到转机，原来AI助手可以为我们处理这些重复任务。

Why: Claude Code Subagents

"又是API开发？每次都要重复相同的步骤：创建路由、验证参数、连接数据库、错误处理、编写测试、更新文档..." 小张看着任务清单叹了口气，这已经是这个月第5次开发类似的API了，每次都要重新走一遍完整流程，光是这些重复工作就花掉了大半天时间。

"这个bug又出现了！" 小王盯着屏幕上的错误信息，"复现问题、定位代码、编写测试用例、修复代码、运行测试、更新文档... 每次修复bug都是这个流程，我都快成流水线工人了。" 他看了看时间，今天上午又有一半时间消耗在这种重复性工作上。

"新功能开发又开始了。" 作为前端开发的李姐苦笑着，"创建组件、状态管理、API集成、测试覆盖、代码审查... 每次新功能都要走这些相同的步骤，感觉像个模板一样，但又要手动执行每一个环节。"

这些真实的工作场景每天都在开发者身上重演。我们投入了大量时间在重复性工作上，却忽略了最核心的业务逻辑开发。更重要的是，重复性工作不仅消耗时间，还容易因为疲劳而出现人为错误——谁没在重复工作中犯过低级错误呢？

问题的根源在于：我们试图用人力解决机器擅长的问题。AI助手应该能够理解我们的工作模式，并为我们处理这些重复性任务。

What: Claude Code Subagents

Claude Code Subagents 是Claude Code中的一个革命性功能，它允许你创建专门的AI助手来处理特定类型的任务。与普通的AI助手不同，Subagents具有以下特点：

核心概念：

  • 专门化设计：每个Subagent专注于特定的任务领域
  • 上下文记忆：保持对话上下文，理解工作流程
  • 工具集成：可以直接操作文件、运行命令、调用API
  • 自主学习：根据使用模式不断优化表现

与普通AI助手的区别：

  • 普通AI助手：需要你详细描述每个步骤，像是在指挥一个新手
  • Subagents：理解你的工作模式，像是在与经验丰富的同事协作

核心价值：

  • 减少重复工作：自动化处理日常开发任务
  • 提高工作质量：减少人为错误，保持代码一致性
  • 节省时间精力：让你专注于创造性工作
  • 知识沉淀：将最佳实践固化为可复用的工具

How: Claude Code Subagents

之前有写过Claude Code配置魔法：从单人编程到专属AI团队协作，使用的是claude-config项目自带的 AI 编程subagents，包括架构师/产品经理/前后端等完整的子代理。

如果你没有使用过subagents，强烈建议先从这篇文章Claude Code配置魔法：从单人编程到专属AI团队协作去感受一下，相信我你一定会回来感谢我！因为我也是开始从这里去体验到subagents的强大魅力，真的很哇塞:)

今天主要演示如何自定义subagent，授之以鱼不如授之以渔:)

参考官方文档：docs.claude.com/en/docs/cla…

编写subagents有固定的结构化格式，这样claude code可以识别出来subagent 并进行调用

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
model: sonnet  # Optional - specify model alias or 'inherit'
---

Your subagent's system prompt goes here. This can be multiple paragraphs
and should clearly define the subagent's role, capabilities, and approach
to solving problems.

Include specific instructions, best practices, and any constraints
the subagent should follow.

官方文档看一眼就可以了，后续会详细解析subagents原理，目前我们就高频地去使用它。

接下来我们不需要自己编写Subagent，直接使用Claude Code创建一个Subagent。

实战示例：Article-Writer Subagent

因为有写技术文章的需求，所以我也在思考如何在实践完成之后输出一篇大家更容易上手的技术文档，同时也需要保障一定的更新频率。

在这个背景下我就想到正好让Claude Code来帮我自定义一个写技术文章的写作助手

让我们创建一个专门的技术文章写作助手：

生成编写技术文章的subagent，名字为article-writer 

1、agents 规范：agents 放在~/.claude/agents/，agents 格式参考官方文档：https://docs.claude.com/en/docs/claude-code/sub-agents

如下为具体文章的规范

2、文章的开头部分结构为：author/title/description/tags/categories

3、文章标题：生动，吸引人，同时体现痛点，带上数字或者引发强烈好奇心的问题

4、文章Description：先重点描写痛点，然后带出自己的思考，最后提一下解决方案，但是不说出最后的答案，吸引用户主动读文章来找出答案

5、整体文章结构：Why-what-how-Scenarios-summary 的结构去展开，文章结尾放上官方的参考链接，文章最后加上：希望本文对你有所帮助，想了解更多AI实践，关注我的同名公众号:)，定期分享AI实战，一起探索AI的无限可能！

6、具体参考这篇文章： @007-openspec/openspec-quickstart.md

7、文字风格：简洁、逻辑清晰，再加一些人文关怀

PS：当然你也可以按照官网的提示首先在Claude Code初始化一个subagent，然后再在对话中填充subagent具体内容，我这里是把我想到的要求一次性列出来了。

生成完成之后，可以查看~/.claude/agents/article-writer.md，后续完善之后可以再翻译为英文，最佳实践里面大家一致认为英文效果会更好。

也可以在Claude Code里面使用/agents查看具体的subagents

使用和微调

创建完成后，开另外一个命令行窗口使用article-writer写一篇关于subagent的文章：

使用article-writer 子代理写一篇文章

主题：claude code subagents QuickStart 入门的技术文章，暂时先不涉及subagents 之间的协作，仅入门文章，教会大家重点编写subagents

痛点和价值主张：解决工作中的重复性问题这个痛点，不是努力地工作，而是更聪明地工作，not work hard, but work smart

HOW 实战：以如何编写article-writer 子代理为例去编写文章，同时直接编写prompt 让 claude code 生成这个subagent，然后进行微调最终达到我们想要的效果

Subagents官方文档：https://docs.claude.com/en/docs/claude-code/sub-agents，文章放到目录 @008-agents/

这篇文章最开始的初稿就是用article-writer这个subagent生成的，然后跟Claude Code 协同微调完成。

根据你的使用反馈，可以一边在窗口 1调整文章，另外一边在窗口 2 让Claude Code完善子代理的功能。

最后考虑到写文章的子代理放在特定的项目目录比较好，所以将~/.claude/agents/article-writer.md移动到当前目录.claude/article-writer.md，项目的.claude的配置优先级是高于全局配置的。

Scenarios: 适用场景

1. 代码全流程开发测试：功能开发、自动化的代码检查、格式化、测试运行

2. 文档生成维护：API文档、技术规范、README文件的自动更新

3. 项目配置管理：环境配置、依赖管理、构建流程的自动化

4. 内容创作辅助：技术文章、教程、案例分析的标准化生成

效果预期

基于实际使用数据，Subagents可以带来：

  • 时间节省：减少70%的重复工作时间，每天多出2-3小时用于创造性工作
  • 质量提升：人为错误减少85%，代码一致性显著改善
  • 团队效率：新成员上手时间缩短50%，知识传承更加系统化
  • 工作满意度：开发者从重复劳动中解放，工作投入度和创造力明显提升

Summary: 掌握Claude Code Subagents的成就感

掌握了Claude Code Subagents，你将获得工作方式的根本性改变。核心技能习得：创建专门化AI助手、自动化重复性任务、建立标准化工作流程。

从繁琐的重复劳动中解放出来，专注于真正有价值的创造性工作。这不仅是效率的提升，更是工作理念的转变 - 从"努力工作"到"聪明工作"的跨越。

希望本文对你有所帮助，想了解更多AI实践，关注我的同名公众号:)，定期分享AI实战，一起探索AI的无限可能！

参考链接

avatar
文章
阅读
粉丝