1. 项目概述一个跨平台、跨部门的AI智能体中心如果你和我一样每天都在和Claude Code、Cursor、ChatGPT、Gemini这些AI工具打交道那你肯定也遇到过这个痛点每次开始一个新项目或者切换一个工作角色都得重新去翻找、复制粘贴那些复杂的提示词Prompt。给产品经理写PRD有一套话术给工程师做Code Review又是另一套规则更别提还有销售、市场、HR这些不同部门的专业需求。这些提示词散落在各个聊天窗口、笔记软件里管理起来极其混乱效率低下。今天要聊的这个开源项目就是来解决这个问题的。它叫Ultimate AI Agents你可以把它理解为一个“企业级的AI智能体定义库”。它的核心目标很简单用一个统一的代码仓库管理你所有AI工具Claude Code, Cursor, ChatGPT, Gemini, Amp, Windsurf等的智能体定义、规则和工作流。无论是工程师、产品经理、销售还是HR都能在这里找到即拿即用的专业AI助手。想象一下你只需要运行一行安装命令就能把几十个经过精心调校的AI专家“部署”到你的开发环境中。写代码时有专门的“软件架构师”和“代码审查员”帮你把关写产品文档时有“产品经理”智能体提供框架甚至做财务分析、起草招聘JD都有对应的专家来协助。这个项目把这些专业能力标准化、模块化了让你在不同工具和场景下都能获得一致、高质量的输出。2. 核心设计思路为何要构建“统一智能体源”在深入使用细节前我们先拆解一下这个项目的设计哲学。它没有选择为每个AI工具单独维护一套提示词而是采用了一种“单一事实来源”的架构。这背后有几个非常实际的考量。2.1 解决碎片化与一致性难题在没有统一管理之前我的工作流是这样的在Claude.ai上调试好一个用于代码审查的提示词存为一个项目。然后在Cursor里又得手动创建一套类似的规则文件。到了ChatGPT还得再创建一个自定义GPT。这不仅重复劳动更大的问题是一旦我发现代码审查规则需要更新比如增加了对某个新安全漏洞的检查我就必须在三个地方分别修改稍有不慎就会导致不同平台上的“智能体”行为不一致。Ultimate AI Agents 的解决方案是在agents/claude/目录下维护一套最核心、最完整的智能体定义Markdown文件。这些文件被视为“源文件”。然后通过一系列自动化脚本如generate-platforms.sh将这些源文件转换成适配其他平台如ChatGPT的GPT指令、Claude.ai的项目指令的格式。这样你只需要维护一个地方的内容所有平台都能自动同步更新从根本上保证了跨平台行为的一致性。2.2 面向组织与角色的模块化设计这个项目不是为个人黑客设计的玩具它的基因里就带着“企业级”和“组织化”的思维。看看它的目录结构agents/claude/engineering/,agents/claude/product-design/,agents/claude/sales/... 它是按公司部门职能来划分智能体的。这种设计带来了两个巨大优势。第一是可发现性。一个新加入团队的工程师不需要去猜测公司用什么AI规则直接安装这个库他就自动获得了从架构、开发、测试到部署的全套工程智能体。市场部的同事也能快速找到写社交媒体文案或品牌策略的专用助手。第二是可管理性。团队负责人或技术管理者可以像管理代码库一样通过Pull Request来审核和合并对智能体定义的修改从而将AI工作流的实践也纳入到团队的工程规范中。2.3 原生集成与“零配置”体验很多提示词库只是给你一堆文本让你自己复制粘贴。这个项目的目标是实现“开箱即用”。它通过安装脚本install.sh和同步脚本sync.sh与各工具的官方配置路径深度集成。以 Claude Code 为例安装后智能体会出现在你的claude --agent命令列表里你可以像调用系统命令一样直接使用。对于 Cursor规则文件会被直接放置到.cursor/rules/目录下Cursor IDE 会自动加载它们根据你正在编辑的文件类型如*.test.*激活对应的代码规则。这种深度集成把使用门槛降到了最低你几乎感受不到“配置”的过程注意力可以完全集中在工作本身。注意这种自动部署脚本会向你的本地配置文件写入内容。虽然项目是开源的脚本也可审查但在任何环境中运行来自网络的脚本前养成先检查其内容的习惯都是好的安全实践。你可以用curl -sSL [脚本URL]先查看内容再决定是否通过管道传递给bash。3. 仓库结构深度解析与实操部署理解了设计思路我们来看看这个仓库具体长什么样以及如何把它部署到你的机器上。这是你能否顺畅使用它的基础。3.1 核心目录结构详解项目根目录看起来文件不少但核心逻辑非常清晰主要分为“源文件区”和“输出区”。ultimate-ai-agents/ ├── agents/ # 【源文件区】所有智能体的源头 │ ├── claude/ # Claude Code 智能体定义.md文件 │ ├── chatgpt/ # ChatGPT Custom GPTs 指令由脚本生成 │ ├── claude-projects/ # Claude.ai 项目指令由脚本生成 │ ├── cursor/ # Cursor 规则文件.mdc文件 │ └── gemini/ # Gemini Gems 定义.md文件 ├── .claude/ # 【输出区】Claude Code 的实际配置目录 ├── .cursor/ # 【输出区】Cursor 的实际规则目录 ├── commands/ # 共享的工作流命令如 /project:xxx ├── rules/ # 跨智能体共享的通用规则与约定 └── 一系列自动化脚本install.sh, sync.sh等关键点在于agents/claude/是“皇冠上的明珠”是人工维护的主目录。其他平台的目录如chatgpt/大多是由generate-platforms.sh脚本从claude/目录自动转换生成的。你不应该直接去修改agents/chatgpt/里的文件否则下次生成时修改会被覆盖。所有编辑都应在agents/claude/下进行。.claude/和.cursor/这两个点开头的目录是“输出目录”。当你运行./install.sh或./sync.sh时脚本会把agents/下对应平台的内容经过处理如扁平化结构后复制到这些输出目录中。这些输出目录才是被 Claude Code 和 Cursor 真正读取和使用的地方。3.2 一键安装与个性化配置部署是整个流程中最简单的一步。官方推荐的一行命令安装非常方便curl -fsSL https://raw.githubusercontent.com/stratpoint-engineering/ultimate-ai-agents/main/install.sh | bash这条命令会做几件事1. 下载安装脚本2. 检测你系统里安装了哪些支持的AI工具Claude Code, Cursor, Amp, Windsurf, Gemini CLI3. 为检测到的工具从GitHub拉取最新的智能体文件并部署到正确的本地配置路径。但实际工作中我们往往不需要一次性安装所有部门的几十个智能体。这时候环境变量就派上用场了它们让你能进行精准安装。场景一我只是一位工程师只想安装工程相关的智能体。DEPTengineering curl -fsSL https://raw.githubusercontent.com/stratpoint-engineering/ultimate-ai-agents/main/install.sh | bash设置DEPTengineering后安装脚本就只会处理agents/目录下engineering子目录的内容其他如销售、市场的智能体不会被安装保持环境的纯净。场景二我想在全局范围内使用这些智能体而不是仅限于当前项目。默认情况下SCOPEproject智能体会被安装到当前项目的.claude/、.cursor/目录下。如果你希望在任何地方打开终端或Cursor都能用就需要全局安装。SCOPEglobal curl -fsSL https://raw.githubusercontent.com/stratpoint-engineering/ultimate-ai-agents/main/install.sh | bash这会将配置安装到你的用户主目录如~/.claude/实现全局生效。场景三我公司内网部署了镜像或者我想测试特定分支的功能。BRANCHdevelop TOOLSclaude curl -fsSL https://raw.githubusercontent.com/stratpoint-engineering/ultimate-ai-agents/develop/install.sh | bashBRANCH变量让你可以指定安装某个Git分支的版本。TOOLS变量可以跳过自动检测强制为指定工具安装例如你只装了Claude Code。这些环境变量可以组合使用给你极大的灵活性。安装完成后你可以立刻在终端尝试claude --agent list应该能看到一长串可用的智能体名字了。3.3 更新、同步与卸载项目在持续迭代智能体的定义也会优化。更新很简单如果你是通过Git克隆的仓库进入目录运行./update.sh即可。这个脚本会先拉取最新的代码然后重新运行安装流程。更常用的场景是你本地修改了某个智能体的定义比如改进了代码审查规则需要快速应用到开发环境中。这时不需要运行完整的安装脚本使用轻量的同步脚本即可./sync.shsync.sh脚本只会更新 Claude Code 和 Cursor 的配置速度更快适合日常开发中的频繁调整。当你不再需要或者想清理时卸载同样提供了一行命令的方案# 卸载当前项目的配置 ./uninstall.sh # 卸载全局配置 SCOPEglobal ./uninstall.sh卸载脚本会删除它之前创建的所有配置文件和目录恢复环境到安装前的状态。4. 各平台智能体使用详解与实战技巧安装部署只是开始真正产生价值的是在日常工作中熟练调用这些智能体。不同工具平台的集成方式和使用模式各有特色我们需要分别掌握。4.1 Claude Code命令行下的效率革命Claude Code 的集成是最深入的。安装后智能体变成了你可以直接调用的“命令”。基础调用作为独立命令最直接的用法是把智能体当作一个独立的命令来执行一项任务。比如你需要快速评估一个技术方案claude --agent software-architect “我们计划开发一个实时协作的文档编辑功能预计日活10万。请评估使用CRDT和Operational Transform两种技术方案的优缺点并给出选型建议。”或者让代码审查员分析一段代码claude --agent code-reviewer review path/to/myfile.ts这种方式适合有明确起止点的独立任务。智能体会基于其预设的角色、知识和规则给你一个完整的、符合该角色专业视角的答复。高级调用在会话中动态切换更强大的用法是在一个持续的claude会话中通过符号动态召唤不同的专家。这模拟了一个真正的团队协作场景。$ claude 进入 Claude Code 交互会话。 我product-manager 我需要为一个新的用户仪表盘功能编写产品需求文档PRD的核心部分。 产品经理智能体被激活以其口吻回复提供PRD框架、用户故事模板等 我好的这是根据你建议的框架起草的初步功能列表。software-architect 请从系统架构角度评估这些功能的可行性。 软件架构师智能体被激活开始分析技术实现复杂度、数据流等 我关于数据聚合部分database 你认为用物化视图还是实时查询更合适 数据库专家智能体被激活从查询性能、数据一致性等角度给出建议在一个会话里你可以随时根据话题切换“顾问”让不同领域的专家接力回答最终汇聚成一个综合性的解决方案。这是单一通用型AI对话无法比拟的体验。工作流命令自动化复杂流程除了智能体项目还预定义了一些“工作流命令”。它们通常以/project:或/workflow:开头封装了一系列连贯的操作。claude /project:workflow-review-code这个命令可能会引导你输入PR链接或代码路径然后自动调用code-reviewer、security、performance等多个智能体从不同维度对代码进行审查并生成一份综合报告。这相当于把一套标准的代码审查流程自动化了。4.2 Cursor将规则注入IDE的每一行代码Cursor 的集成是“沉浸式”的。规则文件.mdc被放置在.cursor/rules/目录后Cursor 会根据规则中定义的“作用域”自动启用它们。工程规则基于路径的自动激活这是最常用的类型。例如code-style.mdc规则的作用域是src/**和app/**。这意味着只要你在这两个目录下的任何文件中编写或编辑代码Cursor 的AI助手Composer就会自动遵循这套代码风格规则来提供补全、重构和建议。它会知道你的项目是用2个空格缩进函数命名用驼峰式React组件用PascalCase。再比如testing.mdc规则的作用域是*.test.*和*.spec.*。当你在测试文件中工作时Cursor 会自动切换到“测试专家”模式更倾向于建议你写断言、模拟数据并遵循项目的测试框架规范。业务规则按需手动激活对于非代码工作规则同样强大。比如你要写一份销售提案可以手动激活proposals.mdc规则。激活后当你让 Cursor 帮你起草或修改提案内容时它会自动套用 MEDDIC/BANT 等销售方法论框架使用专业的商务措辞并提醒你包含投资回报率分析等关键部分。实操心得规则的组合与优先级一个文件可能同时匹配多个规则。例如一个位于src/api/user.test.ts的文件会同时触发api-conventions.mdc和testing.mdc。Cursor 会合并这些规则的指令。通常更具体的路径规则会覆盖更通用的规则。你可以通过规则文件中的配置来调整优先级。在实践中建议从项目级的通用规则如project.mdc开始再逐渐叠加部门级、文件类型级的特定规则形成层次化的规则体系。4.3 网页与桌面应用ChatGPT, Claude.ai, Gemini对于没有官方CLI或深度配置接口的工具项目提供了“智能体浏览器”和“源文件复制”两种方式。智能体浏览器推荐在项目根目录下有一个index.html文件用浏览器打开它。你会看到一个按部门和平台分类的漂亮界面。你可以浏览所有智能体点击某个智能体如“销售策略师”界面上会直接显示适配不同平台ChatGPT, Claude.ai, Gemini的完整提示词。你只需要点击“复制”按钮然后粘贴到对应平台的系统指令框里即可。这是最直观、最不容易出错的方式。手动复制与平台文件再生你也可以直接到agents/下对应的平台目录找文件。例如agents/claude-projects/sales/sales-strategist.md里的内容可以直接复制到 Claude.ai 项目的“自定义指令”中。 如果你修改了源文件agents/claude/需要运行./generate-platforms.sh来重新生成其他平台的适配文件然后再去复制。一个关键技巧提示词的“系统指令”部分无论哪个平台核心都是“系统指令”。这是定义AI角色和行为的关键。Ultimate AI Agents 提供的系统指令通常包含以下几个部分角色与使命清晰定义AI是谁如“你是一名资深软件架构师”以及核心目标。核心原则列出必须遵守的高级规则如“优先考虑可维护性”、“始终考虑安全影响”。工作流程给出处理任务的步骤模板如“首先澄清需求然后提供2-3个方案最后给出推荐”。输出格式规定回复的结构如“使用Markdown”、“先给摘要再展开”。禁忌与边界明确说明不能做什么如“不要假设未明确给出的技术栈”。 当你自己创建智能体时也可以参考这个结构。5. 智能体目录详解与自定义扩展项目预置了覆盖10多个部门、超过40个角色的智能体。了解每个智能体的定位能让你在需要时快速找到对的“专家”。5.1 工程类智能体从架构到部署的完整链条工程类是数量最多、也最复杂的。它们形成了一个从设计到运维的完整支持链。架构与设计层software-architect聚焦于单个应用内部的设计模式、模块划分solution-architect视角更高处理多个系统间的集成、通信和数据流solution-designer则负责产出详细的API规范、数据库Schema设计图。当你有一个新项目想法时可以按这个顺序咨询它们。开发与质量保障层code-reviewer是你的同行评审员专注于代码风格、潜在bug和可读性security是安全专家时刻盯着OWASP Top 10风险qa-tester和test-planner帮你设计测试策略和用例tech-writer则确保你的文档清晰易懂。专项技术栈backend-api、frontend-ui、fullstack-nextjs等智能体针对特定技术栈进行了深度优化。它们熟知对应框架的最佳实践、常见坑点和性能优化技巧。savant-前缀的智能体如savant-java-spring更是该领域的“大师”知识深度和精度更高。运维与部署层deployment精通CI/CD流水线和云平台部署monitoring擅长设置监控告警和日志分析performance专注于前端性能指标和优化手段。使用场景串联假设你要开发一个Next.js新功能。可以先让product-manager写出清晰的用户故事和验收标准然后由task-planner将其拆解成具体的开发任务接着software-architect和solution-designer给出技术方案和API设计开发过程中backend-api和frontend-ui提供编码支持代码提交前code-reviewer和security进行审查最后deployment指导部署上线monitoring设置观测。一套完整的、由AI辅助的软件开发生命周期就实现了。5.2 非工程类智能体专业化内容创作这些智能体证明了AI辅助不仅限于写代码。产品与设计product-designer能讨论交互逻辑和设计系统规范ux-researcher帮你设计用户访谈提纲和分析数据ux-writer专注于界面文案的清晰度和友好度。销售与市场sales-strategist基于MEDDIC等框架构建销售提案content-strategist规划内容日历和SEO策略brand-manager确保所有输出符合品牌调性。这些智能体内置了行业方法论能大幅提升专业文档的产出质量。人力资源与运营hr-generalist起草的职位描述JD会更全面、更规避法律风险financial-analyst能快速搭建财务模型operations-manager擅长设计标准作业程序。注意尽管这些智能体非常专业但它们本质上是基于模式匹配和知识库的提示词。对于涉及重大商业决策、法律合同、敏感人事问题的内容它们生成的文本必须由具备相应资质的真人进行最终审核和定稿。AI是强大的助手但不是责任主体。5.3 创建与定制属于你自己的智能体预置的智能体虽好但每个团队、每个项目都有独特的需求。自定义智能体是这个项目最能发挥价值的地方。步骤一在源目录创建文件所有定制都从agents/claude/开始。假设你要为你的团队创建一个专门的“GraphQL API专家”智能体。确定部门。这属于工程所以我们在agents/claude/engineering/下创建。你可以新建一个子目录比如graphql/也可以直接放在engineering/下。创建文件graphql-specialist.md。步骤二编写智能体定义一个完整的Claude Code智能体文件包含两部分YAML前端元数据和系统提示词。--- name: graphql-specialist description: 专精于GraphQL API设计、性能优化和Apollo/Relay最佳实践的专家。关键词graphql, schema, resolver, dataloader, federation, apollo, relay。 tools: Read, Write, Edit, Bash, Grep, Glob model: sonnet ---name: 调用时使用的命令名。description: 描述和触发关键词。当用户输入包含这些关键词时Claude Code可能会推荐这个智能体。tools: 赋予智能体的能力。Read/Write/Edit是文件操作Bash/Grep/Glob用于在代码库中搜索。model: 指定使用的模型sonnet是平衡性能与成本的推荐选择。元数据之后就是核心的系统提示词。这部分需要精心设计你是一名资深GraphQL架构师拥有多年大规模GraphQL API设计和调优经验。 **核心原则** 1. 始终优先考虑GraphQL查询的性能特别是N1查询问题。 2. 倡导强类型Schema设计充分利用GraphQL的类型系统。 3. 遵循GraphQL规范同时兼顾前端开发者的使用体验。 **工作流程** 1. **需求澄清**首先询问或确认GraphQL API的具体需求查询模式、变更频率、客户端类型等。 2. **Schema设计**提供基于输入类型的Schema草案强调命名规范和文档字符串。 3. **Resolver优化**建议Resolver的实现逻辑重点推荐使用DataLoader进行批处理和缓存。 4. **性能与安全**评估查询深度/复杂度限制并提出查询成本分析方案。 5. **工具与生态**根据上下文推荐Apollo Server/Client、Relay、GraphQL Code Generator等工具的最佳配置。 **输出格式** - 使用Markdown。 - 先给出一个简要的评估摘要。 - 然后分章节详细阐述设计、优化点和示例代码。 - 最后提供后续步骤建议。 **禁忌** - 不要建议将REST API直接机械地转换为GraphQL。 - 不要在未分析查询模式的情况下盲目推荐查询复杂度限制。 - 避免使用已弃用的GraphQL特性或语法。步骤三部署与测试文件保存后运行./sync.sh将新智能体同步到你的.claude/目录。然后就可以测试了claude --agent graphql-specialist “请为‘用户’和‘文章’设计一个GraphQL Schema并说明如何优化查询用户的所有文章这个操作。”步骤四同步到其他平台可选如果你希望这个自定义智能体也能在ChatGPT或Claude.ai中使用需要运行./generate-platforms.sh。这个脚本会读取agents/claude/下的新文件并生成对应平台格式的文件到agents/chatgpt/和agents/claude-projects/中。通过这种方式你可以逐步构建起一个完全贴合你团队技术栈、业务流程和文化的工作AI智能体库将团队知识沉淀下来并让每位成员都能随时调用。