阁子
·
Agency Agents：一座 AI 角色库的分发工程
内容提要
Agency Agents 是一个AI角色库，包含270个带人格的专家角色，按17个事业部组织，支持16种工具。角色以markdown定义，通过convert.sh和install.sh分发安装。仓库用CI确保一致性，但角色不增强模型能力，全量安装会污染上下文，建议按需选择。
延伸解读
角色库的工程化核心：分发与治理
Agency Agents 的亮点不在角色本身，而在于将 270 个 markdown 角色文件通过 convert.sh 和 install.sh 分发到 16 种工具，并依赖 divisions.json 和 tools.json 两份事实源加 CI 对账保证一致性。这种工程化设计让社区仓库能维持秩序，避免因格式差异和目录漂移而散架。
角色不增强模型能力，按需安装是关键
角色本质是提示词工程，不提供新工具或知识，模型能力上限不变。全量安装 270 个角色会污染上下文，导致选择困难和 token 浪费，尤其 roster 形态（如 Aider、Windsurf）会将所有角色拼入文件，每次会话都消耗大量上下文。因此按分部或单个角色安装是正确用法。
质量参差与维护风险需注意
角色质量参差不齐，有的包含资深经验，有的只是岗位 JD 的改写，安装前应阅读文件。同时，16 种工具的目录约定随上游 CLI 演进可能漂移，CI 只能保证仓库内部一致，无法应对上游变化，维护面较大。
Q&A
Agency Agents 是什么？
Agency Agents 是一个包含 270 个带人格的专家角色的 AI 角色库，按 17 个事业部组织，支持 16 种工具。角色以 markdown 文件定义，通过脚本分发安装。
Agency Agents 的角色文件是如何定义的？
每个角色一个 markdown 文件，frontmatter 记录名字、简介、配色、性格标签，正文包含完整人格设定，如身份与记忆、核心使命、铁律、检查单、产出格式。
Agency Agents 如何将角色分发到不同工具？
通过 convert.sh 和 install.sh 实现。convert.sh 根据 tools.json 中的契约将 markdown 渲染成各工具认得的格式，如 Claude Code 用 markdown，Codex 用 TOML，Cursor 用 .mdc 等。install.sh 是交互式安装向导，自动探测已安装工具，支持按分部或单个角色选择安装。
Agency Agents 如何保证仓库的一致性？
通过 divisions.json 和 tools.json 两份事实源，加上 CI 对账。CI 检查目录中的分部是否在 json 中登记，脚本清单与契约是否一致，还有原创性检查防止抄袭。
Agency Agents 的角色能增强模型能力吗？
不能。角色只是提示词工程，不给模型增加新工具或知识，它提供的是领域检查单、产出格式和聚焦，模型能力上限仍是底座本身。
全量安装 Agency Agents 会有什么问题？
全量安装会污染上下文，例如 270 个角色全装进 Claude Code 会让选择器混乱；OpenCode 超过 119 个会静默丢弃；roster 形态（如 Aider、Windsurf）会将全员人格拼进一个文件，每次会话都进入上下文，浪费 token 和注意力。建议按需选择。
Agency Agents 的安装命令是什么？
桌面 App 可通过 brew 安装：brew install --cask msitarzewski/agency-agents/agency-agents。命令行方式：git clone https://github.com/msitarzewski/agency-agents.git && cd agency-agents，然后运行 ./scripts/install.sh，可加参数如 --tool claude-code --division engineering,security。
Agency Agents 的角色质量如何？
质量参差不齐。有 lint 和抄袭检查，但无法保证深度，有的角色是经验总结，有的只是岗位 JD 翻译。建议安装前阅读角色文件，像面试一样筛选。
