先说清楚：它给的是「分工」，不是「能力」

通用提示词的毛病，是所有人都在写同一句「你是一个资深工程师」。这个仓库换了个做法：把 18 个分区里的 282 个岗位各写成一份独立文件，每份都写清四件事——身份与性格、核心任务与工作流、带代码示例的交付物、成功指标与沟通风格，等于一份公开的岗位说明书合集。它不会让模型变强，但会让它在你指定的角色上更稳定：知道自己该交付什么、什么时候该回来提问。

第一步：先挑，不要全装

282 个提示词一次塞进 Agent，上下文会被挤爆，角色之间也会互相打架。先想清楚这个项目缺哪一环：前端实现、后端架构、代码评审、安全、测试，还是市场与内容。仓库 README 里每个分区都有一张「Agent / 擅长什么 / 什么时候用」的表格，照它挑。想按团队配比装，仓库还备了十几套 runbook（例如从零做 MVP 的 startup-mvp），可以直接照单装一队。

第二步：装法一，桌面应用

官方去年出的桌面应用最省事：macOS、Windows、Linux 都有安装包，打开就能浏览整个 roster，勾选之后自动装进你手上的编码工具（Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Windsurf、Aider 等），并且跟着上游更新。不想碰命令行就用这条。

# macOS 用 Homebrew
brew install --cask msitarzewski/agency-agents/agency-agents

# Windows / Linux：到 agencyagents.app 或 GitHub Releases 下安装包

第三步：装法二，脚本按需选装

习惯命令行就克隆仓库跑脚本。默认是交互式向导：先探测你装了哪些工具，再让你挑工具和团队。也可以直接指定目标。任何一次装之前，都建议先加 --dry-run 看一眼它准备写哪些文件、写到哪。

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

./scripts/install.sh --list teams        # 先看每个团队有多少个 agent
./scripts/install.sh --tool codex --division engineering,security --dry-run
./scripts/install.sh --tool codex --division engineering,security

# 只要单个岗位时：
./scripts/install.sh --tool claude-code --agent frontend-developer,ui-designer

要装到列表之外的工具（Copilot、Antigravity、Kimi、Hermes、DeepSeek Harness 等），先跑一次 ./scripts/convert.sh 生成对应格式，再执行 install。还有最原始的第三种装法：把某个 .md 直接拷进 ~/.claude/agents/，Claude Code 就能按名字调它。Windows 上跑 .sh 建议用 Git Bash 或 WSL，正常 shell 里直接双击是不行的。

第四步：装完怎么用——点名激活

装好之后不用改工作流，在对话里点名就行。多角色协作时一次别超过两三个：一个负责实现、一个负责挑毛病，比一次叫来十个都管用。让子代理先只读代码、给出结论，确认方向对了再放它动手改文件，比一上来就让它直接改要安全得多。

activate the Code Reviewer mode and review src/auth/session.ts
activate Frontend Developer mode and help me build a React component

第五步：把它改成你自己的（这步别省）

这些文件是纯文本，改起来没有成本。至少做三件事：删掉你用不到的段落（很多文件带着很长的风格与流程描述，你未必需要）、把项目约定写进去（技术栈、目录结构、提交规范、必须跑的命令）、把「成功指标」换成你团队真正在意的那几条。改完的版本建议进你自己的仓库，而不是留在 ~/.claude/agents/ 里——否则换台机器就丢了，也没法评审。

  • 按项目分目录存放，需要时再拷进 agent 目录，避免全局装了几百个互相干扰
  • 把「必须遵守」和「仅供参考」分开写：前者用祈使句，后者明确标成示例
  • 每改一版留一条变更记录，出问题能回退到上一版
  • 团队共用就走代码评审，别让每个人的角色定义各说各话

第六步：边界与几个已知的坑

  • 它装的是提示词，不是能力：模型本身做不到的事，换个角色照样做不到
  • 提示词来自公开社区，质量参差；用之前先读一遍，尤其是涉及命令、权限、外部接口的部分
  • OpenCode 目前只注册约 119 个 agent，装多了会被静默丢掉一部分——用 --division 把范围控制住
  • 仓库自带 CI 检查（分区一致性、agent 格式、原创性），跟着上游更新时留意这些检查报了什么
  • 别把内部文档、密钥、客户数据粘进任何 agent 提示或对话里
一句话总结：这份仓库最值钱的不是 282 这个数字，而是它示范了「把岗位写成文件」该怎么做——挑三五个改到贴合你的项目，比装两百个放着强。