msitarzewski/agency-agents · 上手攻略
- 仓库：msitarzewski/agency-agents
- 链接：https://github.com/msitarzewski/agency-agents
- 分类：AI Agent · 编码工具集成
- 作者：Tom
- 更新：2026-08-04
是什么
Agency Agents 是一个面向 AI 编码工具的专家 Agent 人格库，以 Markdown 文件形式提供，每个 Agent 都有独立人格、专长域、可交付成果和工作流程。目前支持 Claude Code、Cursor、Codex、OpenCode、Gemini CLI、OpenClaw 等主流 Coding Agent，另有工程、安全、嵌入式、合规等十余个专业团队（如 Frontend Developer、Backend Architect、Solidity 工程师、Incident Response Commander 等）。
其核心价值在于：把"调教 Agent"这件事从写 System Prompt 变成选配专业人格包，每个包自带完整角色定义、交付标准、代码示例和沟通风格。
另有配套桌面应用 Agency Agents App，支持 macOS / Linux / Windows，可以图形化浏览全部 Agent 并一键安装到本地 Coding Agent，无需手动复制文件。
解决什么问题
- Coding Agent 缺乏专业深度：通用 Agent 写 React 组件还凑合，但遇到 Filament PHP Admin 优化、嵌入式固件、Juniper/Palo Alto 网络配置就抓瞎。
- Agent 个性化成本高：手动写 System Prompt 质量不稳定，Agency Agents 把经过验证的 Agent 人格固化下来。
- 跨工具迁移麻烦：同一套 Agent 配置想从 Claude Code 迁移到 Cursor 或 OpenCode，需要手动转换。
快速安装
桌面应用（最简）
直接下载 Releases 对应平台的安装包，或：
# macOS/Linux
brew install --cask msitarzewski/agency-agents/agency-agents
# Windows（需先装好 Homebrew）
桌面应用会自动检测你装了哪些 Coding Tool，一键安装对应 Agent。
命令行（手动）
# 克隆仓库
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
# 安装全部 Agent 到 Claude Code
./scripts/install.sh --tool claude-code
# 或只安装工程团队
./scripts/install.sh --tool claude-code --division engineering
# 查看所有可用团队
./scripts/install.sh --list teams
转换为其他工具格式
# 生成所有支持工具的集成文件
./scripts/convert.sh
# 安装（交互式，自动检测已安装工具）
./scripts/install.sh
# 指定工具和团队
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
核心用法
激活一个 Agent（Claude Code 示例）
安装后在 Claude Code 对话中直接说：
Hey Claude, activate Frontend Developer mode and help me build a React component
Agent 文件里定义了激活关键词、人格特质、工作流程和交付标准，Claude Code 会自动加载对应人格。
OpenCode 集成注意事项
OpenCode 运行时目前只注册约 119 个 Agent（上游 bug），安装过多会被静默丢弃。安装时用 --division 限制子集：
./scripts/install.sh --tool opencode --division engineering
安装脚本会在超限时主动警告。
按团队安装
# 只装安全团队
./scripts/install.sh --tool claude-code --division security
# 只装 Solidity 智能合约工程师
./scripts/install.sh --tool claude-code --agent solidity-smart-contract-engineer
# dry-run 预览
./scripts/install.sh --tool opencode --division engineering --dry-run
典型适用场景
| 场景 | 推荐 Agent |
|---|---|
| 快速搭 React/Vue/Angular 页面 | 🖥️ Frontend Developer |
| 设计 Laravel/Livewire 架构 | 💎 Senior Developer |
| iOS/Android 开发 | 📱 Mobile App Builder |
| Kubernetes / CI/CD 自动化 | 🚀 DevOps Automator |
| ESP32/STM32 固件开发 | 🔩 Embedded Firmware Engineer |
| 智能合约 / DeFi | ⛓️ Solidity Smart Contract Engineer |
| 生产事故响应 | 🚨 Incident Response Commander |
| Filament PHP Admin 优化 | 🔧 Filament Optimization Specialist |
坑与注意
- OpenCode Agent 上限：OpenCode 不支持超过 ~119 个 Agent 注册，官方已确认是 bug，大规模安装需用
--division拆分。 - 非原生 Agent：这些是 CLAUDE.md / .claude/agents 格式的配置，依赖 Coding Tool 支持 Agent 文件加载；旧版工具可能不兼容。
- 桌面应用 vs 命令行：桌面应用自动更新，命令行安装则需手动
git pull。 - Agent 质量参差：各 Agent 由社区贡献，部分专长领域可能需要人工审核其交付标准是否合理。
- 版权归属：Agent 文件按 MIT 许可，但内置的代码示例所有权归属各贡献者。
与同类对比
| 方案 | 定位 | 优势 | 劣势 |
|---|---|---|---|
| Agency Agents | 专业 Agent 人格库 | 支持 10+ 团队、多工具转换、开源免费 | 依赖工具支持 Agent 文件、Coding Tool 自身能力天花板 |
| Claude Code 原生 Agent | 官方能力 | 无需额外安装、与工具深度集成 | 只有通用能力，缺专业深度 |
| Cursor Rules | 项目级规则 | 高度定制化 | 需手动维护，跨项目复用麻烦 |
| OpenAI Codex 内置 | 官方端侧 Agent | 免配置 | 功能封闭，不可扩展 |
一句话结论
如果你已经在用 Claude Code / Cursor / OpenCode，想快速获得嵌入式固件、Solidity 合约、Filament Admin 等专业领域的深度 Agent，Agency Agents 是目前最完整的开源免费方案，安装一条命令就能拥有整支虚拟专家团队。
最小可跑命令（macOS/Linux，Claude Code 已装）： ```bash git clone https://github.com/msitarzewski/agency-agents.git cd agency-agents && ./scripts/install.sh --tool claude-code --division engineering
随后在 Claude Code 对话中说：
"activate Frontend Developer and build a responsive navbar"
硬件需求：无特殊要求，Claude Code 依赖网络 API 调用
```
来源：GitHub README（main 分支）、engineering/engineering-frontend-developer.md、scripts/install.sh --list teams 输出、desktop app release notes。
不确定处：各 Agent 实际交付质量未经实测，建议首次使用前在非生产项目验证；OpenCode Agent 上限 bug 状态以 issue #27988 为准，建议安装前先确认 OpenCode 版本已修复该问题。