agency-agents

一句话召唤一整支AI代理团队，分工干活直接出结果

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 158697

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类智能体

开发团队msitarzewski

所属国家

官网地址

GitHubhttps://github.com/msitarzewski/agency-agents

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型

GitHub 星标★ 158697

30天Star增速

HF 下载量

上线时间2025-10-13 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

agency-agents 是一个面向 AI 智能体（Agent）场景的开源项目，用 Shell 脚本组织了一套“虚拟 AI 代理机构”。它把不同职能的智能体拆分成独立角色，例如前端开发、Reddit 社区运营、创意注入、现实校验等，每个角色都带有自己的性格设定、工作流程和可交付成果。项目要解决的问题是：当人们想用大模型完成多步骤任务时，往往缺少清晰的角色分工和可复用的执行模板，导致提示词散乱、输出质量不稳定。agency-agents 通过预置角色与流程，让用户像调用一支团队一样调用智能体，快速完成内容创作、社区互动、代码辅助等任务。核心能力包括角色化提示词、可组合的代理流程、面向具体交付物的任务设计，以及用 Shell 脚本做轻量编排，降低使用门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS / Linux / Windows 系统，具备 bash 或兼容 shell 环境
本地已安装至少一个目标工具（如 Claude Code、Cursor、Codex、Gemini CLI、Qwen Code、Kimi Code、Osaurus
已安装 git，用于获取项目脚本
使用 Homebrew 安装桌面应用时需 macOS 并已装 Homebrew

安装与启动步骤

1获取项目脚本

克隆仓库后进入项目根目录，后续 convert.sh 和 install.sh 都在项目根目录下执行。
```
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
```
2生成集成文件

运行转换脚本，把角色定义生成为各目标工具所需的格式文件，必须先执行再安装。
```
./scripts/convert.sh
```
3交互式安装

安装器会扫描本机已装工具并显示勾选列表，按提示选择要安装的工具后回车确认。
```
./scripts/install.sh
```
4指定工具安装

若只想装某一个工具，用 --tool 指定目标，例如 cursor、codex、qwen、kimi 等。
```
./scripts/install.sh --tool cursor
```
5非交互批量安装

适合 CI 或脚本场景，--tool all 会一次装到所有检测到的工具，无需人工干预。
```
./scripts/install.sh --no-interactive --tool all
```
6并行加速安装

多核机器上加 --parallel 并行处理各工具，--jobs N 可限制并行数，输出顺序不固定。
```
./scripts/install.sh --no-interactive --parallel --jobs 4
```
7可选：装桌面应用

不想用命令行可安装官方桌面应用，自动浏览并安装角色且保持更新。
```
brew install --cask msitarzewski/agency-agents/agency-agents
```

关键配置

配置项	必填	说明	示例
`--tool`	是	指定要安装的目标工具，如 claude-code、cursor、codex、qwen、kimi。	`./scripts/install.sh --tool cursor`
`--no-interactive`	否	关闭交互式勾选界面，直接按参数安装，适合脚本和 CI。	`./scripts/install.sh --no-interactive --tool all`
`--parallel`	否	并行处理多个工具，加快安装速度，但输出顺序不确定。	`./scripts/convert.sh --parallel`
`--jobs N`	否	限制并行任务数量，默认取 nproc、硬件 CPU 数或 4。	`./scripts/install.sh --no-interactive --parallel --jobs 8`

如何确认成功

安装完成后，在目标工具中能看到对应 agent；例如在 Qwen Code 交互模式下用 /agents 命令查看已安装的代理列表。

常见问题

Q：不想克隆仓库、也不想敲命令怎么办？

A：直接安装官方桌面应用 Agency Agents（支持 macOS、Linux、Windows），可浏览全部角色一键装进 Claude Code、Cursor、Codex、Gemini 等工具，并自动更新。

Q：安装太慢可以怎么加速？

A：在脚本后加 --parallel 让各工具并行处理，再用 --jobs N 控制并行任务数，例如 ./scripts/install.sh --no-interactive --parallel --jobs 4。

Q：不知道本机装了哪些目标工具？

A：直接运行 ./scripts/install.sh 进入交互式安装，安装器会先扫描系统并用 [*] 标记检测到的工具，再让你勾选要安装的项。

Q：装完后怎么在 Qwen Code 里调用代理？

A：可以按名称显式引用，例如“Use the frontend-developer agent to review this component”，也可让 Qwen 根据任务上下文自动委派，或在交互模式用 /agents 管理。

Q：可以在 CI 里静默安装吗？

A：可以，使用 ./scripts/install.sh --no-interactive --tool all，或配合 --parallel 与 --jobs N 加速，全程无需人工选择。

注意事项

必须先执行 scripts/convert.sh 生成集成文件，再运行 scripts/install.sh 安装。
转换和安装脚本需在项目根目录下执行，README 示例中用的是相对路径 ./scripts/。
--parallel 模式下多个工具的输出顺序不确定，日志交错属正常现象。
不同目标工具安装位置不同，如 Kimi 装到 ~/.config/kimi/agents/，Qwen 装到 ~/.qwen/agents，Codex 装到 ~/.codex/agents。

核心亮点

把不同职能拆成独立角色，每个角色有性格、流程和交付物，提示词可直接复用
用 Shell 脚本做编排，依赖少、上手快，适合快速搭原型
角色覆盖前端、社区运营、创意、校验等，场景跨度大，方便按需组合

不足之处

以 Shell 脚本为主，复杂流程的维护和扩展不如 Python/TypeScript 框架灵活
角色质量依赖提示词设计，缺少统一的评测和版本管理机制

适用场景

内容团队用多个角色代理批量生成并校验社交媒体文案
独立开发者快速搭建带角色分工的 AI 工作流原型
社区运营者模拟 Reddit 等平台的互动与内容策略

替代项目

AutoGPT、MetaGPT

上一篇：Awesome-Agentic-System-Design

下一篇：craft-agents-oss