Agency Agents 专业代理角色安装器

要解决什么问题

在真实项目里，编码代理往往只有一种“人格”：它默认扮演通用工程师，理解需求、改代码、跑测试。但产品定义、运营复盘、客服回复、市场文案这些工作，需要的是完全不同的判断框架和关注点。一个只会写代码的代理，被要求去澄清产品需求或解读运营数据时，给出的结果通常流于表面。

Agency Agents 的做法是把“角色”本身抽出来，做成可复用的角色文件（role files），让代理在需要时切换人格。这个技能要解决的问题很具体：如何把上游仓库里的角色文件正确装进本地环境，并让当前代理运行时能识别并使用它们。

技能如何工作

核心流程可以拆成三步：

• 拉取上游角色定义：从 Agency Agents 上游文档中提取角色文件的分类与说明，覆盖工程、产品、市场、客服、运营等方向。
• 按运行时安装：根据你当前使用的代理运行时（如 Claude Code、Cursor、Gemini CLI、Aider、Windsurf、OpenCode、Copilot 等）选择合适的安装路径，让角色文件落到运行时能读到的位置。
• 按需裁剪：角色是按“部门”（division）组织的。如果你只想要产品方向的角色，不必整套引入，可以只复制对应的分类目录。

角色文件本身不绑定某个框架。它本质上是给代理的行为提示与工作流约定：这个角色默认关注什么、用什么标准验收结果、输出什么形式的证明。

适用边界与注意点

• 不是代码框架：这里安装的是角色定义，不是运行时依赖，不会改变代理的模型能力或工具调用范围。
• 质量标准来自上游：上游对某些角色的要求相当严格，例如测试类角色“默认要找出 3-5 个问题，并且对所有结论要求可视化证据”。如果你的团队流程接受不了这种强度，需要先做适配再使用。
• 上游仓库在变动：角色内容来自第三方仓库，本地副本不会随上游更新自动同步，定期重新拉取是必要的。
• 运行时兼容性：虽然支持多个运行时，但各运行时读取角色文件的机制不同。安装后建议先做一次最小验证，确认代理真的切换到了目标角色。