agency-agents 详细介绍：把一整套 AI 专家团队装进开发工具

msitarzewski/agency-agents 把大量专业角色做成可复用的 Agent 定义文件，让 AI 编程工具可以按任务切换专家视角，而不是只有一个泛化助手。

一句话概览

msitarzewski/agency-agents 是一个面向 AI 编程工具和多智能体工作流的 Agent 角色库。它不是单个应用，也不是普通 prompt 合集，而是一组按专业团队拆分的 AI 专家定义文件。

这些 Agent 覆盖工程、设计、营销、销售、产品、项目管理、测试、安全、GIS、游戏开发、财务、学术研究等方向，可安装到 Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Aider、Windsurf、Kimi Code、Osaurus、Hermes 等工具里。

它是什么

每个 Agent 文件通常包含：

• 身份设定。
• 工作方式。
• 任务边界。
• 交付物格式。
• 成功标准。
• 沟通风格。

它更像一个「AI 专家库」，帮助用户在不同任务中快速切换专业视角，而不是自动完成所有工作的万能软件。

项目适合谁

• 经常使用 Claude Code、Codex、Cursor 等工具，希望快速切换专业角色的开发者。
• 想搭建多 Agent 工作流，需要现成角色分工、边界和交付标准的团队。
• 想学习高质量 Agent 定义文件写法的人，包括人格、流程、约束和输出格式。

真正用好它的关键，是选对角色、给清楚上下文，并把 Agent 输出纳入代码审查、测试、合规和发布流程。

安装方式

项目推荐使用桌面应用安装。官方 Agency Agents App 支持 macOS、Linux 和 Windows，可浏览完整 Agent 名单，并一键安装到 Claude Code、Cursor、Codex、Gemini、Osaurus 等工具，同时负责更新。

macOS 可用 Homebrew：

brew install --cask msitarzewski/agency-agents/agency-agents

命令行方式：

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

安装到 Claude Code：

./scripts/install.sh --tool claude-code

只复制某个分类，例如 engineering：

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

安装到其他工具前，先生成集成文件：

./scripts/convert.sh

交互式安装：

./scripts/install.sh

指定工具安装：

./scripts/install.sh --tool cursor
./scripts/install.sh --tool codex
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool opencode
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool kimi
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes

按 division 或 agent 精确选择：

./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

OpenCode 当前运行时只会注册约 119 个 Agent，超过后可能静默丢弃。因此给 OpenCode 安装时最好用 --division 选择子集。

使用方式

安装后，可以在 AI 编程工具中直接让模型切换角色：

Activate Frontend Developer mode and help me build a React component.

更实用的写法，是同时给出任务、上下文和期望交付物：

Activate Backend Architect.
Review this API design, identify scaling risks, and propose a database schema.
Keep the output as decisions, trade-offs, and next implementation steps.

复杂项目可以组合多个 Agent，而不是让一个通用助手包办所有事情。例如：

• Product Manager：整理 PRD 和验收标准。
• Software Architect：评估系统边界。
• Backend Architect：设计 API 和数据结构。
• Frontend Developer：实现界面。
• API Tester 与 Reality Checker：做验证。
• Technical Writer：补文档。

这种组合方式的好处是每个角色负责一个清晰视角，质量控制更容易。

Agent 分类概览

以下是压缩后的分类索引，便于快速理解这个库的覆盖面。

Engineering

代表角色包括 Frontend Developer、Backend Architect、Mobile App Builder、AI Engineer、DevOps Automator、Software Architect、SRE、Code Reviewer、Database Optimizer、Prompt Engineer、Multi-Agent Systems Architect 等。

适合前后端开发、架构设计、AI 集成、CI/CD、可靠性、代码审查、数据库调优、提示词设计和多 Agent 系统治理。

Design

代表角色包括 UI Designer、UX Researcher、UX Architect、Brand Guardian、Visual Storyteller、Image Prompt Engineer、Persona Walkthrough Specialist 等。

适合界面设计、用户研究、品牌一致性、视觉叙事、AI 图像提示和 Persona 认知走查。

Paid Media 与 Sales

Paid Media 覆盖广告账户、搜索词、追踪与测量、创意策略、展示广告、社交广告等。

Sales 覆盖外呼策略、Discovery call、交易策略、售前工程、RFP 提案、pipeline 分析、客户扩张和销售辅导。

适合增长团队、B2B 销售团队和广告投放团队建立更细分的 AI 工作角色。

Marketing

代表角色包括 Growth Hacker、Content Creator、SEO Specialist、LinkedIn Content Creator、Xiaohongshu Specialist、Douyin Strategist、WeChat Official Account Manager、Podcast Strategist、AI Citation Strategist、AEO Foundations Architect 等。

覆盖内容、社交、SEO、短视频、私域、电商、AI 搜索可见性和多平台发布。

Product 与 Project Management

Product 方向包括 Product Manager、Sprint Prioritizer、Trend Researcher、Feedback Synthesizer、Behavioral Nudge Engine。

Project Management 方向包括 Senior Project Manager、Project Shepherd、Experiment Tracker、Meeting Notes Specialist、Jira Workflow Steward。

适合产品发现、路线图、用户反馈、项目推进、实验管理和会议纪要。

Testing

代表角色包括 Evidence Collector、Reality Checker、Test Results Analyzer、Performance Benchmarker、API Tester、Accessibility Auditor。

适合 UI 证据收集、上线门禁、测试结果分析、性能测试、接口测试和无障碍检查。

Security

代表角色包括 Security Architect、Application Security Engineer、Penetration Tester、Cloud Security Architect、Incident Responder、Threat Detection Engineer、Compliance Auditor、Blockchain Security Auditor。

适合威胁建模、安全架构、代码安全审查、授权渗透测试、云安全、检测工程、合规准备和智能合约审计。

Support、Finance 与 Specialized

Support 覆盖客服、分析报告、财务跟踪、基础设施维护、法律合规和高管摘要。

Finance 覆盖记账、财务分析、FP&A、投资研究和税务策略。

Specialized 覆盖 MCP Builder、Document Generator、Automation Governance Architect、Developer Advocate、Data Privacy Officer、Chief of Staff、Customer Success Manager、Workflow Architect、Salesforce Architect 等专业角色。

Spatial Computing、Game Development、Academic 与 GIS

Spatial Computing 覆盖 XR、visionOS、Metal、WebXR 和终端集成。

Game Development 覆盖 Unity、Unreal、Godot、Roblox、关卡、叙事、音频、Shader、多人架构和编辑器工具。

Academic 覆盖人类学、地理学、历史学、叙事学和心理学。

GIS 覆盖制图、空间数据工程、ArcPy、GeoAI、BIM/GIS、3D 场景、无人机测绘和 Web GIS。

真实使用组合

按项目阶段组队，而不是把所有任务交给一个角色。

Startup MVP

可组合：

• Frontend Developer
• Backend Architect
• Growth Hacker
• Rapid Prototyper
• Reality Checker

这套组合覆盖实现、架构、获客路径、快速验证和发布前质量检查。

营销活动

可组合：

• Content Creator
• Twitter Engager
• Instagram Curator
• Reddit Community Builder
• Analytics Reporter

每个平台由对应角色处理语气、内容形态和执行重点。

企业功能交付

可组合：

• Senior Project Manager
• Senior Developer
• UI Designer
• Experiment Tracker
• Evidence Collector
• Reality Checker

适合需要范围管理、实现、设计、实验和验收闭环的团队。

安全或基础设施工作

不要让非安全角色「顺便看看」。更好的顺序是：

1. Security Architect 先做威胁模型。
2. Application Security Engineer 或 Penetration Tester 做代码和攻击面检查。
3. Incident Responder 补应急流程。

使用建议

1. 先少量安装。角色很多，一次装满反而会让工具难找。日常开发可先装 Engineering、Testing、Security；做内容和增长时再装 Marketing、Paid Media、Sales。
2. 给 Agent 明确边界。让 Minimal Change Engineer 修 bug，就告诉它不要重构；让 Software Architect 评估架构，就不要同时要求它直接改代码。
3. 把 Agent 输出当成专业建议，不要跳过验证。代码要跑测试，安全结论要复核，营销和合规建议要结合实际业务与法规。
4. 把这些 Agent 当作写作模板学习。好的 Agent 定义不只是「你是某某专家」，还要包含任务边界、流程、交付格式、质量标准和失败处理方式。

总结

agency-agents 的价值在于把大量专业角色做成可复用的 Agent 定义文件，让 AI 编程工具不再只有一个泛化助手，而是可以按任务切换专家视角。

它最适合被当作「专家角色库」和「Agent 定义范本」：先选择少量高频角色，围绕真实工作流建立组合，再通过测试、审查和发布流程验证输出质量。