项目概览
| 属性 | 信息 |
|---|---|
| 仓库 | msitarzewski/agency-agents |
| 语言 | Shell(94.4%)、Python、JavaScript |
| Stars | 124,596(持续暴涨中) |
| 许可证 | MIT |
| 规模 | 232 个 Agent / 16 个部门 / 10,000+ 行 |
一句话描述:把一整家 AI 数字代理公司装进你的 IDE,从前端开发、Reddit 社区运营,到合同审计、Whimsy 注入器,每个 Agent 都有鲜明人格、固定流程与可交付物。
💡 小插曲:项目还配套发布了原生桌面 App —— agencyagents.app,支持 macOS、Linux、Windows 一键将整个 Agent 名册装进 Claude Code、Cursor、Codex、Gemini、OpenCode、Qwen、Osaurus,无需 clone、无需脚本,自动更新。
核心亮点
1. 完整的「AI 代理公司」组织架构
The Agency 把所有 Agent 按业务部门组织,一眼就能看出每家「数字员工」的专长所在:
| 部门 | 核心职责 | 代表 Agent |
|---|---|---|
| 💻 Engineering | 全栈开发、运维、移动端、AI 工程 | Frontend Developer / Backend Architect / SRE / AI Engineer |
| 🎨 Design | UI/UX、品牌、视觉叙事 | UI Designer / Whimsy Injector / Brand Guardian |
| 💰 Paid Media | 投放、竞价、Tracking | PPC Strategist / GTM Specialist / Ad Creative |
| 💼 Sales | 销售流程与教练 | Outbound Strategist / Deal Strategist / Sales Coach |
| 📢 Marketing | 增长、内容、社媒 | Growth Hacker / Reddit Community Builder / Douyin 策略师 |
| 📊 Product | 优先级、洞察、行为干预 | Sprint Prioritizer / Behavioral Nudge Engine |
| 🎬 Project Management | 多项目治理、流程 | Studio Producer / Jira Workflow Steward |
| 🧪 Testing | 质量门禁、证据、基准 | Evidence Collector / Reality Checker / Accessibility Auditor |
| 🔒 Security | 安全架构、渗透、应急 | Security Architect / Pentester / Incident Responder |
| 🛟 Support | 客服、运营、财务追踪 | Support Responder / Finance Tracker |
| 🥽 Spatial Computing | XR、Vision Pro、WebXR | XR Interface Architect / visionOS Spatial Engineer |
| 🎯 Specialized | 不归属于单一职能的专家 | Agents Orchestrator / MCP Builder / ZK Steward |
2. 强人格 × 强交付物
不同于「请你扮演一个开发者」这种泛泛的提示词,The Agency 里的每个 Agent 都写明:
- 🎭 身份与人格:鲜明的沟通风格、思考方式
- 📋 核心使命:边界清晰的职责范围
- 🛠️ 技术交付物:带可运行代码示例
- ✅ 成功指标:可量化的产出与质量标准
- 🔄 可复用的工作流:步骤化 SOP
- 💡 学习记忆:可演化的最佳实践
举几个有趣的 Agent 人格原话:
“I don’t just test your code — I default to finding 3-5 issues and require visual proof for everything.” — Evidence Collector(测试部门)
“You’re not marketing on Reddit — you’re becoming a valued community member who happens to represent a brand.” — Reddit Community Builder(市场部门)
“Let me add a celebration animation that reduces task completion anxiety by 40%.” — Whimsy Injector(设计部门,UX 复盘时)
3. 14 款 AI 编程工具开箱即用
这是 The Agency 的最大杀手锏:同样的 Agent 名册,自动转换为各工具的原生格式。
| 工具 | 安装目录 | 文件格式 |
|---|---|---|
| Claude Code | ~/.claude/agents/ |
.md 原生 |
| GitHub Copilot | ~/.github/agents/、~/.copilot/agents/ |
.md 原生 |
| Antigravity | ~/.gemini/antigravity/skills/agency-<slug>/ |
SKILL.md |
| Gemini CLI | ~/.gemini/agents/ |
.md |
| OpenCode | .opencode/agents/ |
.md |
| Cursor | .cursor/rules/ |
.mdc |
| Aider | ./CONVENTIONS.md |
单文件汇总 |
| Windsurf | ./.windsurfrules |
单文件汇总 |
| OpenClaw | SOUL.md + AGENTS.md + IDENTITY.md |
多文件 |
| Qwen Code | ~/.qwen/agents/ |
.md SubAgent |
| Kimi Code | ~/.config/kimi/agents/ |
YAML |
| Codex | ~/.codex/agents/ |
TOML |
| Osaurus | ~/.osaurus/skills/ |
SKILL.md |
| Hermes | ~/.hermes/plugins/ |
懒加载插件 |
快速上手
方式一:桌面 App(推荐)
直接下载 Agency Agents App,扫描本机已安装的 AI 工具,多选后一键安装,自动保持更新。macOS 用户也可以:
|
|
方式二:脚本安装(Claude Code)
|
|
激活方式很简单,在 Claude 对话里直接告诉它:
|
|
方式三:跨工具批量安装
|
|
方式四:当作参考资料
每个 Agent 的 .md 文件本身就是结构化文档:
- Identity & personality traits(身份与人格)
- Core mission & workflows(核心使命与流程)
- Technical deliverables + code examples(可交付物与代码示例)
- Success metrics & communication style(成功指标与沟通风格)
直接打开 engineering/engineering-frontend-developer.md 浏览,按需复制改造即可。
技术架构与设计哲学
文件结构
|
|
Agent 设计哲学
README 明确列出 5 条原则:
- 🎭 强人格:不是泛泛模板,而是有血有肉的角色
- 📋 清晰交付物:具体产出,不是模糊指引
- ✅ 成功指标:可量化的结果与质量标准
- 🔄 可复用工作流:经过验证的步骤化流程
- 💡 学习记忆:模式识别与持续改进
与同类方案的差异
| 类型 | The Agency 的差异 |
|---|---|
| ❌ 通用 AI 提示词 | ✅ 深度专业化 + 人格 + 流程 |
| ❌ 一次性 Prompt 库 | ✅ 完整的 Agent 体系,工作流与交付物齐备 |
| ❌ 黑盒 AI 工具 | ✅ 透明、可 fork、可二次改造 |
国际化与本地化
The Agency 已经有 8 种社区维护的本地化版本,其中包含专门的「中国市场原版 Agent」:
| 语言 | 维护者 | 备注 |
|---|---|---|
| 🇨🇳 简体中文 (zh-CN) | @jnMetaCode | 141 个翻译 + 46 个中国市场原创 |
| 🇨🇳 简体中文 (zh-CN) | @dsclca12 | B 站、微信、小红书本地化版 |
| 🇧🇷 葡语 (pt-BR) | @jnMetaCode | 184 个翻译 |
| 🇷🇺 俄语 (ru) | @jnMetaCode | 184 个翻译 |
| 🇮🇩 印尼语 (id) | @jnMetaCode | 184 个翻译 |
| 🇸🇦 阿拉伯语 (ar) | @jnMetaCode | 184 个翻译 |
| 🇰🇷 韩语 (ko) | @jnMetaCode | 184 个翻译 |
| 🇯🇵 日语 (ja-JP) | @sscodeai | 281 个本地化 + 97 个日本原创 + 27 个工作流 |
特别值得关注的是简体中文版包含 B 站、抖音、小红书、知乎、微信、WeChat Mini Program 等中国本地化 Agent —— 这对一个想做中国市场的开发者来说,是现成的"团队"。
多 Agent 协作示例
仓库 examples/ 目录提供真实可运行的多 Agent 协作工作流,例如:
- 启动项目 → Product Manager 出 PRD → Sprint Prioritizer 排期 → 各 Engineering Agent 分头实现 → Evidence Collector 验收 → Reality Checker 签字
- 营销活动 → Reddit Community Builder 调研 → Content Creator 出内容 → Twitter Engager 投放 → X/Twitter Intelligence Analyst 复盘
这类「项目经理 + 多位专家」的协作范式,正是当下多 Agent 系统的最佳实践之一。
适用人群与场景
| 你是谁 | 怎么用 |
|---|---|
| 独立开发者 | 装 Claude Code + Cursor,把 Frontend / Backend / SRE Agent 当作 24h 在线的高级工程师 |
| 创业团队 | 用 Marketing / Sales / Product Agent 跑通从产品定位到冷启动的完整流程 |
| 企业 IT | Security / Compliance / SRE Agent 覆盖等保、SOC 2、ISO 27001 准备 |
| AI 工具玩家 | 一次安装,自动适配 14 款主流 AI 编程 IDE |
| 教育/咨询 | 任何具体业务场景都能找到对应 Agent 替代人工 |
局限与注意事项
- ⚠️ OpenCode 容量限制:当前 OpenCode runtime 只注册约 119 个 Agent,超出部分会被静默丢弃(upstream bug),建议用
--division限定部门 - ⚠️ Prompt 质量参差:232 个 Agent 来自社区贡献,质量有差异,关键场景建议自己 review
- ⚠️ 不是「装上就好」:很多 Agent 需要调用外部 API(如 PPC 需 Google Ads),能力上限取决于接入的工具链
- ⚠️ 零数据训练:所有 Agent 只是 prompt 模板,模型本身的能力才是天花板
资源链接
- 🔗 GitHub 仓库:msitarzewski/agency-agents
- 📦 桌面 App:agencyagents.app
- 💬 社区讨论:GitHub Discussions
- 🐛 问题反馈:GitHub Issues
- 📜 许可证:MIT — 商用、个人随便用,保留 attribution 即可
🎭 The Agency 就像一个永远不会抱怨、永不睡觉、按时交付的 AI 专家团队。当 Claude Code、Cursor、Codex 都开始支持「装一个 Agent 名册就拥有一支 AI 部队」时,单兵作战的开发者第一次拥有了过去只有大厂才拼得起来的「全栈」能力。