Agency Agents

五维评分

优秀点拆解

• 单源多态架构：230+ 个 markdown 角色文件经 scripts/convert.sh 按 tools.json 的 format 契约转成 16 种工具格式（codex TOML/kimi YAML/cursor .mdc/openclaw SOUL.md 等），内容只写一份、处处原生部署，新增工具只需加 JSON 条目和两个函数
• 元数据契约 + CI 门禁：tools.json/divisions.json 作为工具与部门清单的真源，lint-agents.sh 强制 frontmatter 必填 name/description/color、推荐章节、拒绝 CRLF，check-tools.sh/check-divisions.sh 在 CI 里校验 JSON、脚本与磁盘目录三方一致，让 230+ 文件的贡献者生态不劣化
• 可交付物导向的角色模板：每个 agent 由 Identity & Memory → Core Mission → Critical Rules → Technical Deliverables（含代码示例与分级 checklist）→ Success Metrics → Communication Style 构成，如 Code Reviewer 的 🔴🟡💭 分级评论格式、Twitter Engager 的 2.5% engagement rate 硬指标，把专家 SOP 固化为可验收的输出
• 开箱即用的安装体验：install.sh 的 detect_*() 自动探测本机 16 种工具、交互式 checkbox TUI、--division/--agent 子集安装、--dry-run、--parallel，并主动规避 OpenCode 119 agent 上限的上游 bug；另有桌面 App 免命令行安装
• 生态化运营：9 种语言社区翻译分叉（含 agency-agents-zh）、examples/ 下 6 个多 agent 协作工作流剧本（如 8 agent 并行产出产品蓝图）、GitHub Discussions 成功案例征集、贡献指南提供 agent 模板骨架

可复用的设计模式

• 单源 markdown + 多目标转换器：内容用通用 markdown 表达，转换脚本按契约 JSON 输出各平台原生格式（format/installKind 分离：渲染格式 vs 安装机制）
• 元数据真源 JSON + CI 三方一致性校验：把工具/部门清单抽成 JSON，check 脚本保证 JSON ↔ 脚本 ↔ 磁盘目录一致，PR 自动拦截漂移
• frontmatter 契约式内容文件 + lint 门禁：YAML frontmatter 承载结构元数据，正文按固定章节骨架，lint 强制必填字段与推荐章节——内容仓库规模化的质量控制模板
• 专家 SOP 固化骨架：Identity → Mission → Critical Rules → Deliverables → Success Metrics → Communication Style，配合分级 checklist 约束输出格式，可复用于任何 skill 制作

适用场景

边界与注意：角色文件本质是纯系统提示词，不含工具/API 绑定，输出质量依赖底层模型且需手动激活引导；230+ 全量安装会占满上下文与 agent 数量上限（OpenCode 119 上限 bug 已实锤），应子集安装；社区贡献的冷门角色深度与生产验证参差。