学习路径指南
难度等级
初级
预计时长
1-2天
适合人群
对AI智能体感兴趣的新手开发者、希望用AI提升工作效率的非技术用户、想快速构建专业级AI助手的初学者

学习目标:学会如何调用和使用各种专业AI代理来辅助开发、设计、营销等工作,并能根据项目需求选择合适的代理或参考其模式创建自己的AI助手。

前置知识

基本命令行操作 了解

项目基于Shell环境,需要能打开终端并执行简单命令。

文本编辑器使用 了解

需要能查看和编辑文本文件(如代理配置文件)。

AI对话工具基础 了解 (可选)

最好对Claude、ChatGPT等AI工具有基本使用经验,但不是必须。

学习步骤

1

环境准备与项目了解

30分钟

浏览项目主页

访问GitHub项目页面,阅读README顶部的项目描述,了解“The Agency”是什么、能做什么。

重点关注“What Is This?”部分,理解每个代理都是专业化、有性格、能交付实际成果的AI专家。

查看代理目录结构

在GitHub页面上浏览agents/目录,看看有哪些分类(工程、设计、营销等)和具体的代理文件。

不需要详细阅读每个文件,先对代理的丰富性和组织方式有个整体印象。

准备AI对话环境

确保你有一个可用的AI对话工具,如Claude Code(推荐)、ChatGPT、Cursor等。

Claude Code对代码处理友好,但其他支持长上下文和文件上传的工具也可用。

2

快速上手体验

1小时

选择第一个代理

从“Engineering Division”中选一个最接近你需求的代理,比如“Frontend Developer”(前端开发)。

如果你是开发者,从工程类开始;如果是设计师或营销人员,从对应分类开始。

查看代理文件内容

打开选中的代理文件(如frontend_developer.md),阅读其“Identity”、“Core Mission”、“Workflows”等部分。

注意代理的“沟通风格”和“交付物示例”,这是使用时的关键参考。

在AI工具中调用代理

将代理文件中的核心描述(特别是身份、使命、工作流程)复制到你的AI对话工具中,作为系统提示或对话开头。

可以这样说:“我将扮演前端开发专家,我的使命是...”,然后提出一个具体任务,如“请帮我用React创建一个登录组件”。

3

核心使用模式掌握

2-3小时

尝试不同调用方式

按照README的“Quick Start”,体验两种使用方式:1) 在Claude Code中直接使用;2) 作为参考模板,复制并修改代理描述以适应你的具体需求。

方式1适合快速求助;方式2适合将代理内化为你的长期AI助手。

理解工作流程与交付物

仔细阅读一个代理的完整工作流程步骤和交付物示例(如代码片段、检查清单、成功指标)。

尝试让AI代理按照其工作流程逐步执行一个任务,并检查交付物是否符合示例标准。

跨代理协作体验

尝试一个需要多个代理的任务。例如,先让“Frontend Developer”创建UI,再让“UI Designer”优化视觉,最后让“Reality Checker”进行质量检查。

可以在同一对话中切换代理角色,或开启多个对话分别使用不同代理。

4

实践与定制

2-4小时

应用于真实项目

选择一个你正在进行的或计划中的小项目(如个人网站、博客、小工具),挑选2-3个相关代理来辅助完成。

从项目规划、设计、开发到测试,都可以尝试引入对应代理。记录使用前后的效率对比。

定制专属代理

参考现有代理的格式(身份、使命、工作流程、交付物),为你自己的专业领域或特定任务创建一个新的代理描述。

可以复制一个相近的代理文件,修改其专业领域、性格特点和交付物要求。

探索高级用法

尝试将代理描述与AI工具的特定功能结合,如Claude Code的代码解释器、文件上传分析,或创建可重复使用的预设(Custom Instructions)。

将你最常用的代理描述保存为AI工具的“系统提示”或“角色预设”,方便一键调用。

推荐资源

项目README 必看

最核心的指南,包含项目理念、快速开始、所有代理的目录和简介。

代理文件本身 必看

每个.md文件都是一个完整的代理说明书,是学习和使用的直接材料。

项目GitHub Issues/Discussions 推荐

查看其他用户的使用反馈、问题讨论,可能找到使用技巧或常见问题解答。

Claude Code官方指南 可选

如果使用Claude Code,了解其高级功能(如代码解释器、长上下文处理)能更好地发挥代理能力。

学习路径常见错误

1

直接复制粘贴整个长文件给AI,导致上下文混乱或超出限制。

提取代理的核心身份、使命和关键工作流程(前几段),而非整个文件。或者分次提供信息。

2

期望代理完全自动执行,不提供清晰的上下文和具体需求。

使用代理时,先简要说明你的项目背景、当前进度、具体问题和期望的交付物,就像对真人专家做任务简报一样。

3

同时使用多个代理角色导致AI身份混淆。

在切换代理时,明确告诉AI“现在我们将切换角色,你将扮演...”,或开启新的对话会话给新代理。

4

忽视代理的“成功指标”和“交付物示例”,导致结果不符合预期。

在任务开始时,就明确引用代理文件中定义的“成功指标”和“交付物”格式作为验收标准。

学习路径下一步步骤

1. 深入研究与你领域最相关的几个代理,将其工作流程融入你的日常习惯;2. 尝试组合多个代理完成一个复杂项目(如全栈应用),探索代理间的最佳协作模式;3. 贡献你创建的优秀代理描述回项目(通过Pull Request),丰富代理生态;4. 探索将代理与自动化脚本、API结合,实现更智能的工作流。

助手