msitarzewski/agency-agents

🎭 The Agency – AI 专家代理库

这是什么 – 一个精选的基于 Markdown 的 AI 代理 定义目录。每个文件描述一个角色（例如：前端开发人员、AI 工程师、UI 设计师）、其专业知识、典型工作流程、交付物和成功指标。这些代理旨在加载到代码辅助工具（Claude Code、Cursor、Gemini CLI、OpenCode 等）中，以便模型在您要求“激活前端开发人员模式”时采用指定角色并像专家一样行事。

为什么重要 – 无需为每个任务编写临时提示词，您可以选择一个现成的、经过实战检验的角色，其中已包含：

• 清晰的身份和语气
• 领域特定的知识和流程
• 具体的输出期望（代码片段、架构图、文档等）
• 判断成功的指标

这加速了提示词工程，提高了团队间的一致性，并使得在不同 LLM 驱动的开发环境中轻松共享“专家”行为。

---

🚀 快速开始

1. 使用原生桌面应用（推荐）

• 从 Agency Agents 应用（macOS、Linux、Windows）或通过 Homebrew 下载最新版本：

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

• 该应用允许您浏览完整列表，并一键将选定的代理安装到任何受支持的工具中。它还会保持代理的最新状态。

2. 命令行安装（无需应用）

1. 克隆仓库（或仅下载 scripts/ 文件夹）。
2. 运行安装脚本，并指定您使用的工具：

   ./scripts/install.sh --tool claude-code          # Claude Code
   ./scripts/install.sh --tool cursor               # Cursor
   ./scripts/install.sh --tool opencode             # OpenCode
   # …或 README 中列出的任何其他受支持工具
   

3. 可选地，将安装限制在特定部门或代理：

   ./scripts/install.sh --tool claude-code \
       --division engineering,security
   ./scripts/install.sh --tool cursor \
       --agent frontend-developer,ui-designer
   

4. 安装后，在工具内激活代理，例如：

   Hey Claude, activate Frontend Developer mode and help me build a React component.
   

3. 作为参考库使用

• 每个 *.md 文件包含完整的角色定义。您可以将定义复制粘贴到自己的提示词库中，或为自定义工具进行改编。
• strategy/runbooks.json 文件将代理映射到运行手册，从而为大型项目实现自动化团队设置。

---

📂 里面有什么？

工程部门（约 120 个代理）

• 前端 / UI – React、Vue、Angular、设计系统集成。
• 后端 / 架构 – API 设计、微服务、云基础设施。
• AI / ML – 模型训练、部署、RAG 管道、后训练栈。
• DevOps / SRE – CI/CD、成本优化、事件响应、可靠性工程。
• 专业角色 – Solidity 合约、嵌入式固件、语音 AI 管道、知识图谱工程等。

设计部门

• UI 设计师、UX 研究员、品牌守护者、趣味注入者、图像提示工程师、包容性视觉专家等。

（完整列表在 README 中列出，并为每个代理附有简短的“何时使用”描述。）

---

🛠️ 技术细节

• 代理格式 – Markdown 文件（engineering/*.md、design/*.md），包含结构化部分：身份、使命、工作流程、交付物、成功指标。
• 安装脚本 – Bash 脚本（install.sh、convert.sh），用于生成特定工具的集成文件（例如，Claude Code 代理文件夹、Cursor 片段）并将其复制到适当的用户目录。
• 多工具支持 – 安装程序自动检测已安装的助手，并可针对任何列出的工具（Claude Code、Cursor、Gemini CLI、OpenCode、Copilot 等）。
• 运行手册 – strategy/runbooks.json 为常见项目类型（例如，“startup-MVP”）定义代理团队（名册）。安装程序可以读取运行手册并批量安装所需的代理。
• 限制 – 某些运行时（例如，OpenCode）对可注册的代理数量有硬性上限；安装程序会在超过该限制时发出警告。

---

👥 谁应该使用这个？

• 开发人员，他们依赖 LLM 驱动的编码助手，并希望获得特定角色、可复现的提示词。
• 产品团队，构建内部 AI 助手管道，需要经过验证的角色库。
• 提示词工程师 / AI 运维人员，为专业代理（安全、数据工程师、RAG 管道等）寻找起点。
• 教育工作者 / 培训师，希望获得如何为 LLM 构建代理角色的具体示例。

---

📦 发布与贡献

• 最新版本 – 请参阅 README 中的 下载应用 徽章；配套桌面应用单独版本化。
• 许可证 – MIT（非常宽松，适合商业使用）。
• 贡献 – 欢迎提交 PR；该仓库鼓励社区添加代理和改进现有定义。

---

底线 – The Agency 提供了一个现成的、可扩展的 AI 代理角色库，可将通用 LLM 转变为领域特定专家，并提供工具将其安装到最流行的代码辅助环境中。