1.5: 自定义子代理

• 完成时间： 20-25 分钟
• 前提要求： 模块 1.4（用于并行工作的代理）

在 Claude Code 中启动这个模块： 运行 /start-1-5 来开始互动体验。

📖 概述

模块 1.5 教你如何创建自定义子代理 - 具有独特个性、专业知识和视觉身份的永久 AI 团队成员。与你在模块 1.4 中学习的临时即席代理不同，自定义子代理是可重复使用的专家，你可以随时调用。

关键要点： 自定义子代理将 Claude Code 从单个助手转变为完整的专业化团队。与其每次都告诉 Claude 像工程师一样行事，你可以构建一个真正的工程师子代理，具有个性、专业知识和视觉区别（颜色和表情符号！），你可以反复调用。

🎭 什么是自定义子代理？

核心概念

自定义子代理是存储在你的项目 .claude/agents/ 文件夹中的预配置 AI 角色。每个子代理都有：

• 带表情符号的名称（在终端中视觉显示！）
• 颜色编码（紫色、蓝色、绿色、红色等）
• 角色定义（背景、专业知识、沟通风格）
• 专业知识（他们擅长什么）

将它们想象为雇佣永久团队成员，他们始终可用且永远不会忘记上下文。

自定义子代理 vs 即席代理

理解差异至关重要：

即席代理（模块 1.4）：

• 为特定任务即时创建
• 一次性工作的临时工
• 示例：创建10个代理来总结这些会议记录
• 使用场景：类似任务的并行处理

自定义子代理（模块 1.5）：

• 你重复调用的预构建角色
• 具有专业知识的永久团队成员
• 示例：👨‍💻 工程师，审查这个技术规范
• 使用场景：你经常需要的专业视角

何时使用哪个：

关键差异： 即席代理用于并行做很多事情。自定义子代理用于获得你经常需要的专业视角。

🗂️ 设置指南：访问 .claude/agents/ 文件夹

自定义子代理位于隐藏的 .claude/agents/ 文件夹中。

在 Mac 上

在 Finder 中按 Cmd+Shift+. 显示隐藏文件，然后导航到你的项目文件夹并打开 .claude/agents/

在 Windows 上

在文件资源管理器中，点击 查看 选项卡 → 勾选 隐藏的项目，然后导航到你的项目文件夹并打开 .claude/agents/

注意： Obsidian 无法显示隐藏文件夹。使用 Finder/Explorer 或 VS Code 编辑 .claude/ 文件。

📄 子代理文件结构

每个子代理都是一个简单的 markdown 文件，包含三个部分：

子代理文件剖析

# [表情符号] [名称]
 
## 颜色
[颜色名称]
 
## 角色
[背景、专业知识、沟通风格 - 2-3段]
 
## 专业知识
- [技能1]
- [技能2]
- [技能3]
- [等等]

示例：工程师子代理

# 👨‍💻 工程师
 
## 颜色
紫色
 
## 角色
你是一位经验丰富的软件工程师，在顶级科技公司（Google、Meta、初创公司）有10+年经验。你深入思考技术架构、可扩展性、性能和实现细节。
 
在分析功能或规范时，你提供：
- 技术可行性评估
- 实现复杂性估算
- 潜在挑战和边缘情况
- 性能和可扩展性考虑
- 具体、明确的建议
 
你的沟通风格：
- 直接和务实
- 关注技术上什么是可能的 vs 理想的
- 早期标记风险
- 当某事不可行时建议替代方案
- 平衡完美主义与发布
 
你通过发现差距、模糊性和技术挑战来帮助产品经理编写更好的技术规范。
 
## 专业知识
- 系统架构和设计模式
- API 设计和数据库架构
- 性能优化和可扩展性
- 技术可行性评估
- 发现边缘情况和错误状态
- 实现复杂性估算

关键元素：

• 表情符号和名称： 调用时出现在终端中
• 颜色： 视觉区分（紫色、蓝色、绿色、红色、黄色、青色、洋红色）
• 角色： 2-4段描述背景、专业知识和沟通风格
• 专业知识： 具体技能的项目列表

🛠️ 创建你的第一个子代理

让我们从头开始创建一个 QA 测试员子代理。

步骤1：导航到 .claude/agents/ 文件夹

使用上述方法在 Finder/Explorer 中打开你项目的 .claude/agents/ 文件夹。

步骤2：创建新文件

创建一个名为：qa-tester.md 的新文件

命名约定：

• 使用小写
• 使用连字符表示空格
• 以 .md 结尾
• 示例：data-analyst.md、tech-writer.md、growth-pm.md

步骤3：编写角色

复制此模板并自定义：

# 🔍 QA 测试员
 
## 颜色
红色
 
## 角色
你是一位细致的 QA 专业人士，在微软、Atlassian 和快速发展的初创公司等企业软件测试方面有8+年经验。你全面思考其他人忽略的边缘情况、错误状态和用户错误场景。
 
在审查功能或用户故事时，你提供：
- 综合测试用例生成
- 边缘情况识别（没人想到的奇怪场景）
- 错误状态分析（当事情出错时会发生什么）
- 可访问性和可用性测试考虑
- 跨浏览器和跨平台兼容性关注
 
你的沟通风格：
- 彻底和注重细节
- 建设性批评（你早期发现问题）
- 有条理（你按严重性分类问题）
- 务实（你建议解决方案，而不仅仅是问题）
- 用户倡导（你像犯错误的最终用户一样思考）
 
你通过在问题到达用户之前捕获问题来帮助产品经理发布更高质量的产品。
 
## 专业知识
- 测试用例生成和测试计划创建
- 边缘情况和错误状态识别
- 验收标准验证
- 用户错误场景分析
- 回归测试策略
- 可访问性测试（WCAG 合规）
- 跨浏览器和设备兼容性
- 负载和性能测试考虑

步骤4：保存和测试

保存文件，然后在 Claude Code 中测试：

# 启动 Claude Code
claude
 
# 调用你的新子代理
🔍 QA 测试员，审查 @user-stories.md 中的这些用户故事并识别
潜在边缘情况和缺失的测试场景

你应该看到带有 QA 表情符号的红色输出！

提示： 在 Claude Code 中运行 /agents 随时查看你所有配置的子代理。

👥 预构建子代理

👨‍💻 工程师（紫色）

• 技术可行性审查
• 实现复杂性估算
• 架构反馈

💼 高管（蓝色）

• 将更新转换为高管总结
• 利益相关者沟通
• 战略业务框架

👤 用户研究员（绿色）

• 分析用户访谈
• 识别痛点和模式
• 综合定性研究

💼 真实产品管理示例

技术规范的工程师：

👨‍💻 工程师，审查 @dashboard-prd.md 并识别技术挑战、
性能影响和实现复杂性

利益相关者沟通的高管：

💼 高管，将 @sprint-update.md 转换为专注于业务影响和指标的
3点高管总结

访谈分析的用户研究员：

👤 用户研究员，分析 /interviews 中的所有文件并识别
带有支持引用的前3个痛点

🎯 产品经理的其他子代理想法

• 📊 数据分析师 - A/B测试、指标、统计分析
• ✍️ 技术写作者 - 文档、帮助文章、发布说明
• 🎯 营销产品经理 - 定位、上市策略、发布规划
• 🎨 用户体验设计师 - 用户流程、设计反馈、可访问性审查
• 🧪 增长产品经理 - 实验、引导、留存策略
• 🛡️ 安全专家 - GDPR、SOC2、合规、数据隐私
• 🎤 客户成功 - 引导、采用、流失分析

💡 最佳实践

角色设计：

• 给出具体背景和专业知识（而不是通用的”你是有帮助的”）
• 定义清晰的沟通风格
• 用2-4段让他们感觉像真人

何时创建自定义子代理：

• 每周或更频繁地需要相同视角
• 用于你重复使用的专业知识
• 构建一致的团队工作流程

🐛 故障排除

看不到 .claude/ 文件夹？

• Mac：在 Finder 中按 Cmd+Shift+.
• Windows：在文件资源管理器中启用”隐藏的项目”

子代理没有响应？

• 包含表情符号：👨‍💻 工程师，审查这个
• 检查文件在 .claude/agents/ 中并以 .md 结尾
• 重启 Claude（exit 然后 claude）

调用多个子代理：

👨‍💻 工程师，审查 @spec.md 的技术可行性。
然后 🔍 QA 测试员，审查其测试覆盖率。

📚 资源

• Awesome Claude Code Sub-Agents - 社区子代理模板集合
• Sub-Agent Examples - 真实代理配置
• SubAgents.cc - 子代理模板生成器

🚀 下一步是什么？

你现在知道如何创建自定义子代理 - 具有专业知识的永久团队成员，你可以重复调用。

模块1.6： 了解 CLAUDE.md 的项目记忆 - 给 Claude 关于你的产品、团队和偏好的永久上下文。

互动模块：输入 /start-1-6

About This Course

Created by Carl Vellotti. If you have any feedback about this module or the course overall, message me! I’m building a newsletter and community for PM builders, check out The Full Stack PM.

Source Repository: github.com/yuezheng2006/claude-code-pm-course