msitarzewski / agency-agents

msitarzewski/agency-agents

open_in_new前往仓库

一个完整的AI代理机构触手可及——从前端专家到Reddit社区达人，从趣味注入者到现实检验者。每个代理都是拥有个性、流程和可靠交付成果的领域专家。

项目概览

项目概述

agency-agents（The Agency）是一个开源的 AI 智能体（Agent）集合，旨在为用户提供一套完整的、可直接使用的 AI 专家团队。该项目由 Reddit 社区讨论催生，经过数月迭代，目前包含 230+ 个高度专业化的 AI 智能体，覆盖工程、设计、营销、销售、产品、项目管理、测试、安全、支持、空间计算、GIS、医疗、金融、游戏开发、学术等多个领域。每个智能体都拥有独特的个性、工作流程和可交付成果，而非简单的提示词模板。项目支持将智能体安装到多种 AI 编程工具中，如 Claude Code、Cursor、Codex、Gemini CLI 等，并提供配套的桌面应用（Agency Agents）以简化安装和管理。

核心功能

  • 丰富的智能体库：提供 230+ 个专业智能体，每个智能体包含身份、个性、核心任务、技术交付物、工作流程、成功指标等结构化内容。
  • 多工具集成：支持将智能体安装到 Claude Code、GitHub Copilot、Antigravity、Gemini CLI、OpenCode、Cursor、Aider、Windsurf、OpenClaw、Qwen Code、Kimi Code、Codex、Osaurus、Hermes 等主流 AI 编程工具。
  • 一键安装脚本：提供 convert.sh 和 install.sh 脚本，可自动生成各工具所需的格式文件，并交互式选择安装目标工具和智能体团队。
  • 桌面应用：提供原生桌面应用（macOS、Linux、Windows），可浏览智能体列表并一键安装到支持的 AI 工具中，支持自动更新。
  • 社区驱动：鼓励用户贡献新智能体、改进现有智能体、分享使用案例，并提供详细的贡献指南。
  • 多语言本地化：社区维护了多种语言的翻译版本，包括简体中文、葡萄牙语、俄语、印尼语、阿拉伯语、韩语、日语、越南语等。

适用与不适用场景

适用场景：

  • 希望快速为 AI 编程助手（如 Claude Code、Cursor）配置专业领域专家角色的开发者。
  • 需要跨职能 AI 团队支持的项目，如 MVP 开发、营销活动、企业功能开发、付费媒体账户接管等。
  • 希望借鉴成熟 AI 智能体设计模式，构建自定义智能体的团队。
  • 需要将 AI 智能体集成到多种工具链中的用户。

不适用场景：

  • 需要完全自主运行、无需人工干预的自动化系统（智能体仍需用户激活和引导）。
  • 对智能体输出有严格合规要求的生产环境（智能体内容仅供参考，需人工审核）。
  • 希望获得开箱即用、无需配置的完整解决方案的用户（需要一定的安装和配置步骤）。

技术架构与依赖

  • 语言：Shell（主要脚本语言），智能体文件为 Markdown 格式。
  • 依赖：需要 Bash 环境（Linux/macOS），Windows 用户建议使用 WSL 或桌面应用。
  • 架构：项目采用目录结构组织智能体，按部门（division）分类，如 engineering/、design/、marketing/ 等。divisions.json 和 tools.json 分别定义部门和工具集，作为配置的单一事实来源。convert.sh 负责将 Markdown 智能体转换为各工具所需的格式，install.sh 负责安装到目标工具目录。
  • 外部服务：部分智能体可能依赖外部服务（如 API、SaaS 工具），在智能体文件的 frontmatter 中通过 services 字段声明。

安装与快速开始

方式一：使用桌面应用（推荐）

  1. 访问 agencyagents.app 下载适用于 macOS、Linux 或 Windows 的桌面应用。
  2. 安装并打开应用，浏览智能体列表，选择目标 AI 工具，一键安装。

方式二：使用命令行脚本

  1. 克隆仓库：git clone https://github.com/msitarzewski/agency-agents.git
  2. 进入目录：cd agency-agents
  3. 生成集成文件：./scripts/convert.sh
  4. 交互式安装：./scripts/install.sh（自动检测已安装的工具，并显示选择界面）
  5. 或指定工具安装：./scripts/install.sh --tool claude-code

方式三：手动复制

将智能体文件复制到对应工具的目录，例如：

cp engineering/*.md ~/.claude/agents/

典型使用方法

在 Claude Code 中激活智能体：

安装后，在 Claude Code 会话中直接引用智能体名称，例如：

Hey Claude, activate Frontend Developer mode and help me build a React component

在 Cursor 中使用规则：

安装后，Cursor 会自动应用 .cursor/rules/ 中的规则，可显式引用：

Use the @security-engineer rules to review this code.

在 OpenCode 中使用：

安装后，在 OpenCode 中通过 @agent-name 引用，例如：

@backend-architect design this API.

自定义安装：

只安装特定团队或智能体：

./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer

配置与部署要点

  • 配置文件：divisions.json 定义部门列表，tools.json 定义工具集，修改后需运行 scripts/check-divisions.sh 和 scripts/check-tools.sh 验证。
  • 生成集成文件：每次新增或修改智能体后，需重新运行 ./scripts/convert.sh 以生成各工具的集成文件。
  • 安装目录：不同工具的安装目录不同，例如 Claude Code 为 ~/.claude/agents/，Cursor 为 .cursor/rules/，OpenCode 为 .opencode/agents/。
  • OpenCode 限制：OpenCode 运行时仅注册约 119 个智能体，超出部分会被静默丢弃，建议使用 --division 参数安装子集。
  • 并行安装：可使用 --parallel 参数加速安装，但输出顺序不确定。
  • 许可证：MIT 许可证，可自由使用、修改和分发。

限制、风险与许可证

  • 限制：智能体内容为 Markdown 提示词，实际效果取决于底层 AI 模型的能力；部分智能体可能依赖外部服务，需自行配置 API 密钥。
  • 风险：智能体输出可能包含错误或不准确信息，需人工审核；安装脚本可能修改系统文件，建议先备份。
  • 许可证：MIT License，允许商业和个人使用，无需署名（但建议注明来源）。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CONTRIBUTING.md 文档。
  • 分析时间：2025年4月（基于当前仓库内容）。