1. 项目概述一个触手可及的AI专家团队如果你和我一样每天都在和各种AI助手打交道从代码生成到内容创作从数据分析到方案策划那你一定也经历过这样的时刻面对一个复杂的任务你不得不花费大量时间像导演一样向一个“通才型”AI反复解释背景、定义角色、设定约束、纠正偏差。这个过程本身就消耗了本应用于创造性工作的精力。我们需要的不是一个需要手把手教的实习生而是一个个召之即来、来之能战、战之能胜的专业“特种兵”。这正是msitarzewski/agency-agents这个开源项目试图解决的问题。它不是一个单一的AI工具而是一个精心构建的、不断壮大的“AI专家人才库”。你可以把它想象成一个数字化的“复仇者联盟”或“专家顾问团”。项目创始人从一次社区讨论中获得灵感经过数月的迭代将这些专家“人格”固化下来形成了这个独特的集合。每个“特工”都不仅仅是一个简单的提示词模板。它们被设计成拥有深度专业领域知识、独特沟通风格、明确工作流程和可交付成果的独立个体。比如当你需要优化前端性能时你可以召唤“前端开发专家”当你需要策划一场社交媒体活动时“Reddit社区构建者”或“TikTok策略师”已经整装待发甚至当你需要为你的项目注入一些趣味性时“奇思妙想注入者”会为你提供意想不到的创意角度。这个项目的核心价值在于标准化与专业化。它把那些在特定领域内被反复验证有效的AI交互模式封装成一个个即插即用的“专家人格”。这极大地降低了使用门槛让你能快速组建一个虚拟的、全栈的AI团队去应对从技术开发、产品设计、市场营销到项目管理、客户支持乃至游戏开发的各类挑战。无论你是独立开发者、初创团队还是大公司里希望提升效率的部门这个项目都能为你提供一个结构化的起点让你与AI的协作从“通用对话”升级为“专业协作”。2. 核心设计理念与架构解析2.1 从“通才”到“专家”角色化AI的范式转变传统的AI助手交互模式是“一问一答”式的。用户是提问者也是领域专家需要不断引导AI。Agency-Agents项目则实现了一次范式转换它将AI定位为特定领域的“专家”而用户则更像是“项目经理”或“客户”。这种转变带来了几个根本性的优势预设的上下文与心智模型每个特工文件都预先加载了其专业领域的知识框架、思维模式和术语体系。例如“软件架构师”特工会默认从系统设计原则、权衡分析、可扩展性等角度思考问题而不是从一个通用聊天机器人开始。结构化的工作流程特工们被设计为遵循特定的工作流程。比如“项目牧羊人”特工可能会按照“需求澄清 - 任务分解 - 进度跟踪 - 风险预警”的流程来运作。这确保了协作过程的可预测性和产出质量。明确的交付物导向每个特工都清楚自己的产出是什么。是代码、设计稿、营销方案、测试报告还是项目计划这种以交付物为目标的设计使得协作结果更加具体、可衡量。这种设计背后的逻辑是降低认知负荷。用户无需在每次交互中都重建上下文特工已经“自带干粮”准备好了专业的工具箱和工作方法。2.2 模块化与可组合的“特工”生态系统项目的目录结构清晰地反映了其模块化思想。特工们被分门别类地组织在不同的“部门”下如工程部、设计部、市场部等。这种分类不仅仅是形式上的它暗示了特工之间的潜在协作关系。横向专业化在同一部门内特工们覆盖了该领域的不同细分职能。例如在“工程部”你有负责前端、后端、移动端、AI工程、DevOps、安全等不同方向的专家。这允许你根据项目的具体技术栈精准匹配专家。纵向工作流跨部门的特工可以串联成一个完整的工作流。例如一个新产品功能的上线可能涉及“产品经理”定义需求 - “软件架构师”设计系统 - “前端/后端开发专家”实现 - “测试工程师”进行质量保证 - “DevOps自动化专家”部署上线 - “增长黑客”进行推广。你可以按需调度这些特工形成一个虚拟的、自动化的项目流水线。这种生态系统的可扩展性极强。社区可以基于现有的模板创建新的特工来覆盖更多领域如法律咨询、金融分析、生物医药等不断丰富这个“人才市场”。2.3 多工具集成一次定义处处运行一个非常实用的设计是项目的多工具集成能力。它没有将自己绑定在某个特定的AI编码工具上而是通过脚本 (convert.sh,install.sh) 自动生成适配不同主流工具的配置文件。Claude Code这是项目的原生和推荐环境。特工文件可以直接放入Claude Code的代理目录在对话中通过简单的指令如“激活前端开发模式”即可调用。Cursor, Aider, Windsurf 等对于使用其他AI编程助手的开发者项目提供了转换脚本。这些脚本会读取特工的核心定义并生成对应工具所能识别的配置文件如cursor.md,.aiderignore.yml的特定章节等。工作原理本质上每个特工都是一个精心编写的Markdown文件其中包含了系统提示词、角色设定、能力范围、工作示例和沟通风格。转换脚本的作用是将这份通用的“角色说明书”翻译成不同工具的“方言”。这保证了特工的核心逻辑一致性同时获得了最大的平台兼容性。实操心得在实际使用中我建议先将项目克隆到本地运行./scripts/convert.sh生成所有适配文件然后再运行./scripts/install.sh。安装脚本会智能检测你系统上已安装的工具并交互式地询问你是否要为每个工具安装对应的特工配置。这个设计非常贴心避免了手动配置的麻烦。3. 深度特工解析以“工程部”与“市场部”为例为了更具体地理解特工的价值我们深入剖析两个核心部门的几位代表性专家。3.1 工程部典范前端开发专家 vs. 软件架构师前端开发专家不仅仅是一个会写React组件的助手。一个成熟的前端专家特工其能力模型至少包含以下几个层次技术栈深度它必须精通现代前端框架React, Vue, Svelte及其生态状态管理、路由、构建工具。更重要的是它要理解这些技术选型背后的权衡。例如当用户提出要构建一个高交互度的管理后台时特工可能会优先推荐React Ant Design/Material-UI并给出理由而对于一个需要极致性能的营销落地页它可能会建议使用Astro进行静态生成并搭配Preact。性能与最佳实践它内置了对Core Web VitalsLCP, FID, CLS的理解。在编写代码时它会主动考虑懒加载、代码分割、图片优化、缓存策略。它会提醒你“这个组件可能需要使用React.memo来避免不必要的重渲染”或者“这里的数据获取可以考虑使用SWR或React Query来管理缓存和状态”。开发者体验好的特工会关注代码的可维护性和团队协作。它会遵循一致的代码风格如使用Prettier、ESLint的规则编写清晰的JSDoc注释设计易于测试的组件接口。它甚至能就项目该使用pnpm、yarn还是npm提出基于依赖管理效率和磁盘空间的分析。沟通风格这个特工可能被设定为务实、注重细节的风格。它的回复会结构清晰先给出方案概述再分步骤实现最后附上关键代码片段和解释。它不会说“我可以帮你写一个按钮”而是会说“基于你的需求我建议实现一个可访问的、支持主题定制的按钮组件。以下是具体实现其中我使用了aria-label确保无障碍访问并通过CSS变量暴露了颜色定制接口...”相比之下软件架构师特工则工作在更高的抽象层问题分解与边界划分它的首要任务是将模糊的业务需求转化为清晰的技术问题。当用户提出“我们要做一个能支持百万用户的社交应用”时架构师特工会开始提问以澄清需求实时性要求多高数据一致性级别如何主要的读写比例是多少基于这些答案它才会开始构思微服务划分、数据库选型SQL vs NoSQL、缓存策略和消息队列的引入。模式与反模式它熟稔各种架构模式Clean Architecture, DDD, CQRS, Event Sourcing及其适用场景。它会指出“在这个场景下使用事件溯源可能过度设计一个简单的CRUD模型加上审计日志可能更合适”或者“考虑到团队规模较小初期采用单体架构快速迭代但需要保持模块间清晰的接口边界为未来拆分做准备”。非功能性需求可扩展性、可维护性、安全性、成本。架构师特工会系统地考虑这些因素。例如在设计API时它会考虑版本化策略在设计数据库时它会考虑分库分表或读写分离的路径它会提醒你关注第三方服务的SLA和降级方案。交付物它的产出可能不是具体的代码而是系统架构图如C4模型、技术选型评估报告、核心模块的接口定义OpenAPI Spec, gRPC proto文件、以及关键的部署和运维考量清单。注意事项不要期望一个特工解决所有问题。正确的使用方式是让“软件架构师”先完成高层设计然后将各个模块的具体实现任务分派给“前端开发专家”、“后端架构师”、“数据库优化师”等特工。这模拟了真实团队中的协作模式。3.2 市场部典范SEO专家 vs. 增长黑客SEO专家特工的工作远不止于关键词研究。一个全面的SEO特工应具备以下能力维度技术SEO审计它能分析网站结构识别影响爬虫抓取和索引的问题如错误的 robots.txt 规则、破损的链接、缓慢的页面加载速度、不当的 canonical 标签、缺失的sitemap、或渲染依赖JavaScript导致的SEO问题。它会提供具体的修复建议例如“建议为SPA应用实施动态渲染或服务器端渲染SSR以确保内容能被搜索引擎正确抓取”。内容策略与语义分析它理解搜索意图的分类导航型、信息型、交易型、商业调查型并能基于此规划内容。它会建议创建“支柱页面”和“集群内容”来建立主题权威。在评估内容时它会分析语义相关性和实体关联而不仅仅是关键词密度。本地化与区域策略对于面向特定市场的项目如项目中提到的百度SEO专家特工需要深谙本地搜索引擎的规则。例如针对百度它会强调备案的重要性、对中文分词的优化、以及百度自家产品如百家号、百度百科的利用策略。数据分析与监控它能指导如何设置和分析Google Search Console、Google Analytics 4 或其他分析工具中的数据将排名、点击率、展示量等指标与业务目标关联起来并制定持续的优化循环。而增长黑客特工则更加激进和实验驱动增长漏斗构建它擅长于拆解用户从认知、获取、激活、留存、推荐到收入的整个旅程AARRR模型并找出每个环节的优化点。例如在“激活”环节它可能会设计一个更流畅的新手引导流程在“推荐”环节它可能设计一个病毒式传播的邀请机制。低成本实验设计增长黑客的核心是快速试错。这个特工会帮你设计A/B测试或多变量测试从改变按钮颜色、文案到测试完全不同的注册流程。它关注的核心指标是“北极星指标”所有实验都围绕提升这个指标展开。杠杆利用它善于发现和利用现有的平台红利或网络效应。例如在某个社交平台推出新功能时如早期的Instagram Stories或微信的视频号快速制定策略抢占早期流量红利。它也可能设计一些“产品内嵌的传播机制”比如Dropbox的“邀请好友获得额外空间”。自动化与工具链增长黑客特工会推荐一系列工具来自动化营销流程如邮件自动化工具、社交媒体管理工具、用户行为分析工具等并将它们整合到一个连贯的增长体系中。4. 实战部署与工作流集成4.1 环境准备与特工“入职”假设你是一名全栈开发者日常使用Cursor作为主力IDE同时也在探索Claude Code。你想为你的下一个项目——一个面向创作者的SaaS平台——组建AI团队。步骤一获取特工档案# 克隆仓库到本地 git clone https://github.com/msitarzewski/agency-agents.git cd agency-agents步骤二生成跨平台配置运行转换脚本这会将所有特工的“核心定义”编译成各工具能理解的格式。./scripts/convert.sh这个命令会在项目内生成_converted/目录里面包含了针对 Claude Code、Cursor、Aider、Windsurf、Gemini CLI 等工具的适配文件。步骤三选择性安装运行安装脚本。它会自动检测你系统里安装了哪些支持的工具并为你提供交互式安装选项。./scripts/install.sh例如检测到你安装了 Cursor它会问“检测到 Cursor。是否要为 Cursor 安装特工(y/n)” 输入y它就会将对应的.md文件复制到 Cursor 的代理配置目录中通常是~/.cursor/agents/。步骤四验证与调用安装完成后打开你的 Cursor。当你新建一个聊天或进入“Agent”模式时你应该能在代理列表里看到新加入的“Frontend Developer”、“Backend Architect”等选项。选择其中一个你的对话上下文就被设定为该特工的角色和知识范围。踩坑记录初次使用时我发现在某些系统上Cursor 的代理目录路径可能不同。如果安装脚本没有自动找到你需要手动确认 Cursor 的配置目录位置可以在 Cursor 设置中查找然后手动将_converted/cursor/下的.md文件复制过去。同样对于 Claude Code默认路径是~/.claude/agents/但如果你通过其他方式安装如 VS Code 插件路径也可能变化。4.2 构建一个完整的项目协作流让我们模拟一个真实场景你需要快速验证一个“在线设计协作工具”的创意。阶段一产品定义与市场验证激活特工产品经理趋势研究员协作过程你向“产品经理”描述初步想法“我想做一个简化版的Figma专注于原型评审和反馈收集。”产品经理特工会追问核心用户、关键痛点、与现有工具的差异点。然后“趋势研究员”特工被引入它会分析当前设计工具市场的竞争格局、用户讨论热点可能从Reddit、Hacker News等渠道提取信息、以及潜在的增长机会如是否有一个未被充分服务的细分领域如教育机构或非设计师群体。产出一份精简的产品需求文档PRD初稿和一份市场竞争分析报告。阶段二技术方案设计与原型构建激活特工软件架构师前端开发专家React方向后端架构师协作过程将PRD交给“软件架构师”。它会设计系统架构前端可能采用React Recoil/Zustand状态管理配合Canvas库如Konva或Fabric.js实现绘图后端采用Node.js WebSocketSocket.io实现实时协作数据存储使用PostgreSQL存储元数据和Redis存储实时状态和会话。然后分别将前端和后端的设计细节交给对应的开发专家开始编写原型代码。产出系统架构图、API接口文档、以及一个可运行的最简可行产品原型代码库。阶段三内容创作与早期推广激活特工内容创作者增长黑客Reddit社区构建者协作过程“内容创作者”根据产品特点撰写博客文章、制作演示视频脚本。“增长黑客”设计一个简单的病毒循环例如用户邀请一名团队成员加入协作双方都可获得高级功能试用期延长。“Reddit社区构建者”则策划如何在 r/design, r/webdev, r/SideProject 等子版块进行有价值的、非垃圾广告的分享比如分享在构建这个工具过程中解决某个技术难题的经验从而自然地引出产品。产出启动期的内容日历、增长策略文档、以及针对特定社区的互动话术指南。阶段四质量保障与部署激活特工测试工程师证据收集者DevOps自动化专家协作过程“证据收集者”特工会自动遍历原型的核心用户流程注册、创建项目、添加评论等并截取每个步骤的屏幕截图生成一份带图的测试报告直观展示功能是否正常。“DevOps自动化专家”则帮忙编写 Dockerfile、GitHub Actions 或 GitLab CI 的配置文件实现代码推送后自动测试、构建镜像并部署到云服务器如Vercel for frontend, Railway/Render for backend的流水线。产出自动化测试脚本、CI/CD流水线配置、部署文档。通过这样一条流水线你一个人就相当于指挥了一个小型创业团队在极短的时间内完成了从想法到可演示、可推广原型的全过程。每个特工都在其最擅长的领域贡献价值而你作为“总指挥”负责决策和协调。5. 高级技巧与定制化开发5.1 如何“面试”和评估一个特工不是所有特工都适合你的具体场景。你需要学会评估和选择。打开一个特工的.md文件例如engineering/engineering-frontend-developer.md关注以下几个部分身份与使命开头的部分定义了特工是谁、它的核心目标是什么。这决定了它的“思考原点”。一个好的特工应该有清晰、聚焦的使命。核心工作流程特工如何处理一个任务是遵循“理解需求 - 提供方案 - 迭代反馈 - 交付”的通用流程还是有更专业的步骤例如“安全工程师”特工的工作流程可能包括“威胁建模 - 代码审查 - 渗透测试建议 - 修复验证”。能力范围与限制特工明确说明自己擅长什么如“精通React Hooks和性能优化”以及不擅长或不会做什么如“不负责视觉设计只关注功能和逻辑”。清晰的边界可以避免无效的交互。沟通风格与示例特工是如何说话的是正式严谨还是活泼鼓励文件中提供的对话示例是评估其实际交互效果的最佳参考。看看这些示例是否解决了真实、复杂的问题。成功指标有些特工会定义如何衡量自己的成功。例如“数据库优化师”的成功指标可能是“查询响应时间降低50%”或“索引覆盖率达到90%以上”。这有助于你判断它的输出是否达标。5.2 混合调用与上下文管理有时一个任务需要多个特工的技能。你需要管理好对话上下文避免混乱。顺序接力这是最简单的方式。在一个对话中完成与特工A的协作后你可以手动总结关键结论然后切换到特工B并将总结作为新对话的输入。例如“这是架构师设计的API接口规范。现在请以后端开发专家的身份根据这份规范实现用户管理模块的RESTful API。”并行协作对于更复杂的项目你可能需要同时打开多个聊天窗口或工具实例每个窗口运行一个不同的特工。你需要自己充当信息枢纽在不同特工间传递和同步信息。这要求你有较强的项目管理和信息整合能力。使用“特工协调员”项目里有一个专门的特工协调员。这个特工的设计目的就是管理多个特工的工作流。你可以将总体目标告诉协调员它会帮你分解任务并在理论上协调其他特工的工作。不过在当前的技术条件下这种协调大多还是需要人工介入来解读和转发信息。核心技巧无论采用哪种方式保存关键的中间输出至关重要。将架构图、API文档、核心代码片段等保存为独立的文件或笔记。这些材料不仅是最终交付物的一部分也是你在不同特工间切换时保持上下文连贯的“交接棒”。5.3 创建你自己的专属特工开源项目的最大魅力在于可定制。如果你发现现有特工无法满足你的特定需求比如你公司内部有一套独特的开发框架或业务流程完全可以基于模板创建自己的特工。找到模板最好的模板就是项目中现有的特工文件。选择一个与你目标领域最接近的特工文件作为起点。定义核心要素身份给你的特工起一个响亮的名字和明确的头衔如“XX云部署专家”、“跨境电商物流顾问”。使命用一句话清晰说明它存在的目的如“专精于将容器化应用一键部署到阿里云ACK集群并优化其成本与性能”。专业知识详细列出它掌握的特定技术、工具、流程如Kubernetes, Helm, 阿里云VPC/SLB配置基于Prometheus的监控告警规则编写。工作流程描述它接到任务后的典型处理步骤。沟通风格设定它的语气如简洁、注重实操、喜欢用命令行示例。示例对话提供2-3个高质量的示例展示它如何解决典型问题。这是“训练”特工最关键的部分。测试与迭代在你的AI工具中加载这个自定义的特工文件用真实的任务去测试它。观察它的回答是否符合预期并根据结果反复调整提示词特别是示例对话部分。这是一个不断打磨的过程。贡献回馈如果你的特工具有通用价值可以考虑向原项目提交Pull Request丰富这个生态让更多人受益。6. 常见问题与效能最大化指南6.1 问题排查速查表问题现象可能原因解决方案特工在列表中不显示1. 安装脚本未正确复制文件到目标目录。2. AI工具未正确识别代理文件格式。1. 手动检查目标目录如~/.cursor/agents/是否存在对应的.md文件。2. 确认文件内容为纯Markdown且开头有正确的YAML Frontmatter如果工具需要。重启AI工具。特工行为不符合描述1. 特工定义文件中的提示词不够精确或存在冲突。2. 当前对话的上下文过长导致特工的初始设定被“淹没”。1. 仔细阅读特工文件检查其“约束”部分是否清晰。可尝试自己微调提示词。2. 开启新的聊天会话并确保第一条指令就明确激活该特工模式。多特工协作时信息混乱上下文在切换过程中丢失或混淆。采用“顺序接力”法时务必在切换前用文字明确总结上一步的关键决策和输出作为给下一个特工的输入。特工给出的方案过于理想化或脱离实际AI缺乏真实世界的约束感知如预算、时间、团队技能、技术债务。你作为人类必须充当“现实锚点”。在给特工分派任务时主动加上约束条件例如“请设计一个后端API考虑到我们团队目前只熟悉Python和PostgreSQL且需要在两周内上线MVP。”生成的代码有错误或过时AI的知识存在截止日期且无法感知你项目特有的依赖版本或环境。1. 始终将AI生成的代码视为“初稿”必须进行人工审查和测试。2. 在提问时明确指定技术栈版本如“请使用React 18和TypeScript 5.0编写”。6.2 提升效能的黄金法则任务拆解要足够细不要给特工一个模糊的宏大指令如“帮我开发一个电商网站”。而是拆解成原子任务“设计用户数据库Schema”、“实现用户注册登录API”、“创建商品列表React组件”。越具体的指令得到的结果越精准。提供充足的上下文虽然特工自带专业知识但它不了解你的项目详情。在开始前花几分钟简要介绍项目背景、技术选型、已有的代码结构可以粘贴相关文件路径或片段。这能极大减少来回澄清的时间。善用“继续”和“迭代”如果特工的回答中途停止或不够完整直接输入“继续”。如果对某部分不满意明确指出问题并要求重做或调整例如“这个函数没有处理错误情况请添加try-catch块并返回友好的错误信息。”结合外部工具特工是强大的“思考者”和“编写者”但你可以用其他工具来增强它。例如用图表工具如Mermaid虽然项目禁止在输出中使用但你可以自己画来可视化架构用终端实际运行它生成的命令和代码并将错误信息反馈给它进行调试。建立你的“特工偏好”库经过一段时间的使用你会发现某些特工在特定任务上表现格外出色或者你形成了自己的一套提问模板。将这些发现记录下来形成你自己的“最佳实践手册”未来可以快速复用。这个项目代表了一种更高效、更专业的人机协作未来。它不再要求每个人都成为精通如何与AI对话的“提示词工程师”而是将专业能力封装成即取即用的服务。你可以专注于更高层次的决策、创意和整合而将大量执行层面的专业工作委托给这些不知疲倦的AI专家。开始探索这个“人才库”根据你的需求组建你的第一个虚拟团队你会发现独自一人所能驾驭的项目复杂度和产出效率将远超你的想象。