学习目标:学会如何调用和使用各种专业AI代理来辅助开发、设计、营销等工作,并能根据项目需求选择合适的代理或参考其模式创建自己的AI助手。
前置知识
项目基于Shell环境,需要能打开终端并执行简单命令。
需要能查看和编辑文本文件(如代理配置文件)。
最好对Claude、ChatGPT等AI工具有基本使用经验,但不是必须。
学习步骤
环境准备与项目了解
30分钟浏览项目主页
访问GitHub项目页面,阅读README顶部的项目描述,了解“The Agency”是什么、能做什么。
重点关注“What Is This?”部分,理解每个代理都是专业化、有性格、能交付实际成果的AI专家。
查看代理目录结构
在GitHub页面上浏览agents/目录,看看有哪些分类(工程、设计、营销等)和具体的代理文件。
不需要详细阅读每个文件,先对代理的丰富性和组织方式有个整体印象。
准备AI对话环境
确保你有一个可用的AI对话工具,如Claude Code(推荐)、ChatGPT、Cursor等。
Claude Code对代码处理友好,但其他支持长上下文和文件上传的工具也可用。
快速上手体验
1小时选择第一个代理
从“Engineering Division”中选一个最接近你需求的代理,比如“Frontend Developer”(前端开发)。
如果你是开发者,从工程类开始;如果是设计师或营销人员,从对应分类开始。
查看代理文件内容
打开选中的代理文件(如frontend_developer.md),阅读其“Identity”、“Core Mission”、“Workflows”等部分。
注意代理的“沟通风格”和“交付物示例”,这是使用时的关键参考。
在AI工具中调用代理
将代理文件中的核心描述(特别是身份、使命、工作流程)复制到你的AI对话工具中,作为系统提示或对话开头。
可以这样说:“我将扮演前端开发专家,我的使命是...”,然后提出一个具体任务,如“请帮我用React创建一个登录组件”。
核心使用模式掌握
2-3小时尝试不同调用方式
按照README的“Quick Start”,体验两种使用方式:1) 在Claude Code中直接使用;2) 作为参考模板,复制并修改代理描述以适应你的具体需求。
方式1适合快速求助;方式2适合将代理内化为你的长期AI助手。
理解工作流程与交付物
仔细阅读一个代理的完整工作流程步骤和交付物示例(如代码片段、检查清单、成功指标)。
尝试让AI代理按照其工作流程逐步执行一个任务,并检查交付物是否符合示例标准。
跨代理协作体验
尝试一个需要多个代理的任务。例如,先让“Frontend Developer”创建UI,再让“UI Designer”优化视觉,最后让“Reality Checker”进行质量检查。
可以在同一对话中切换代理角色,或开启多个对话分别使用不同代理。
实践与定制
2-4小时应用于真实项目
选择一个你正在进行的或计划中的小项目(如个人网站、博客、小工具),挑选2-3个相关代理来辅助完成。
从项目规划、设计、开发到测试,都可以尝试引入对应代理。记录使用前后的效率对比。
定制专属代理
参考现有代理的格式(身份、使命、工作流程、交付物),为你自己的专业领域或特定任务创建一个新的代理描述。
可以复制一个相近的代理文件,修改其专业领域、性格特点和交付物要求。
探索高级用法
尝试将代理描述与AI工具的特定功能结合,如Claude Code的代码解释器、文件上传分析,或创建可重复使用的预设(Custom Instructions)。
将你最常用的代理描述保存为AI工具的“系统提示”或“角色预设”,方便一键调用。
推荐资源
最核心的指南,包含项目理念、快速开始、所有代理的目录和简介。
每个.md文件都是一个完整的代理说明书,是学习和使用的直接材料。
查看其他用户的使用反馈、问题讨论,可能找到使用技巧或常见问题解答。
如果使用Claude Code,了解其高级功能(如代码解释器、长上下文处理)能更好地发挥代理能力。
学习路径常见错误
直接复制粘贴整个长文件给AI,导致上下文混乱或超出限制。
提取代理的核心身份、使命和关键工作流程(前几段),而非整个文件。或者分次提供信息。
期望代理完全自动执行,不提供清晰的上下文和具体需求。
使用代理时,先简要说明你的项目背景、当前进度、具体问题和期望的交付物,就像对真人专家做任务简报一样。
同时使用多个代理角色导致AI身份混淆。
在切换代理时,明确告诉AI“现在我们将切换角色,你将扮演...”,或开启新的对话会话给新代理。
忽视代理的“成功指标”和“交付物示例”,导致结果不符合预期。
在任务开始时,就明确引用代理文件中定义的“成功指标”和“交付物”格式作为验收标准。
学习路径下一步步骤
1. 深入研究与你领域最相关的几个代理,将其工作流程融入你的日常习惯;2. 尝试组合多个代理完成一个复杂项目(如全栈应用),探索代理间的最佳协作模式;3. 贡献你创建的优秀代理描述回项目(通过Pull Request),丰富代理生态;4. 探索将代理与自动化脚本、API结合,实现更智能的工作流。
相关项目推荐
ohmyzsh/ohmyzsh
🙃 社区驱动的卓越框架(拥有2400多名贡献者),用于管理zsh配置。包含300多个可选插件(rails、git、macOS、hub、docker、homebrew、node、php、python等)、140多种主题焕新每日体验,以及可轻松同步社区最新更新的自动更新工具
obra/superpowers
Claude Code 超级能力:核心技能库
d3/d3
使用SVG、Canvas和HTML让数据跃然呈现
anthropics/claude-code
Claude Code是一款基于终端的智能编程工具,它能理解您的代码库并通过自然语言命令执行常规任务、解释复杂代码和处理git工作流,从而帮助您更快地完成编码工作。
nvm-sh/nvm
Node 版本管理器 - 符合 POSIX 标准的 bash 脚本,用于管理多个活跃的 node.js 版本
base/node
Everything required to run your own Base node