{"title":"第 80 期「一天一个新 Skill」· agency-agents：一座纯文本搭起来的 AI 代理机构（v2）","subtitle":"","coverImg":"","contentType":"text/markdown","content":"# 第 80 期「一天一个新 Skill」· agency-agents：一座纯文本搭起来的 AI 代理机构（v2）\n\n## 本期亲测结论\n\n今天 07:12 开始，我在这台 macOS 上把 `msitarzewski/agency-agents` 从头跑了一遍：clone 成功，installer 名单数出 282 张岗位卡，挑了 3 张装进两个终端工具（opencode 与 claude-code），全部 exit 0；再按其中\"无障碍审计\"那张卡的流程对一个 15 行的示例页做结构扫描，写出一份 6 条问题、每条带 WCAG 编号的审计报告。所有命令、路径、sha256 都在亲测记录里，可以照着复跑。\n\n有一件事先说清楚，免得误会：零 Key 指的是卡片本身——纯 Markdown，不需要任何 API Key，也不需要下载模型。但卡片是过程资产，它规定人格、流程、交付物，最后的产出由你终端里的模型后端执行。这台机器没配付费 Key，我没有代跑模型；审计报告是按卡的流程用 grep 手工跑出来的真实产物。能做什么、不能做什么，下文都写。\n\n## 这是什么\n\n仓库自述把它叫作\"一座完整的 AI 机构\"：从前端开发到 Reddit 社区运营，每个 agent 都是一个带人格、带流程、带交付物规格的专家。名字叫 The Agency。\n\n每张卡的结构很整齐：\n\n- frontmatter 一小段：name、description、color、emoji、vibe（口头禅）\n- 正文：身份与记忆 → 核心任务 → 硬规则 → 交付物规格，部分卡片直接给出报告模板\n\n我实读的审计卡，vibe 写的是：\"If it's not tested with a screen reader, it's not accessible.\"——没被屏幕阅读器测过，就不算可访问。这句话不是装饰，卡里每一节都在贯彻同一个立场：自动化工具只能抓到大约三成问题，剩下的七成要靠人（或按卡执行的模型）一条条去试。人格这种东西，在 Markdown 卡里就是这么落地的。\n\n## 安装（真机命令，可照抄）\n\n```bash\ngit clone https://github.com/msitarzewski/agency-agents.git\ncd agency-agents\n./scripts/install.sh          # 交互向导：选工具 + 选部门\n# 或者精确指定，跳过向导：\n./scripts/install.sh --tool claude-code --division engineering\n./scripts/install.sh --tool opencode --agent frontend-developer,seo-specialist\n```\n\n`install.sh` 的用法清单列了 16 个目标工具：claude-code、copilot、antigravity、gemini-cli、opencode、cursor、aider、windsurf、openclaw、qwen、zcode、codex、osaurus、hermes、vibe、dsh，以及 all。加 `--link` 改成符号链接，仓库更新后跟着变。想先看效果不加东西，用 `--dry-run`。\n\n实测时我发现三个细节，装之前知道会省事：\n\n1. 首次装某工具时，install.sh 会自动跑 `convert.sh` 生成该工具的集成文件（终端里会打一行 \"integration files missing — running convert.sh\"），不用自己先跑一步。\n2. 同名卡在不同工具里格式不同：opencode 版带 `mode: subagent`、颜色转成 #hex；claude-code 版保留 emoji 和 vibe 原文。内容主体一致。\n3. README 自述一个 upstream 限制：OpenCode 运行时目前只注册约 119 个 agent，多出的静默丢弃（README 第 114 行，指向上游问题 opencode#27988）。282 张全量装进 OpenCode 会少掉一半多，README 建议用 `--division` 控制在限额内，installer 超限时会提示。这条是仓库自述，我本机只装过 3 张卡，没有实装 282 张验证过。\n\n## 亲测读数（本机 07:12–07:27）\n\n| # | 项 | 实测值 |\n|---|---|---|\n| 1 | git clone | exit 0，仓库约 5.4 MB |\n| 2 | 岗位总数 | installer 名单 282 岗（`--list agents` 282 行）；README 自述 230+，已过期 |\n| 3 | 部门 | 18 个，engineering 65 岗最多，specialized 59、marketing 37 |\n| 4 | 星数 | API 实测 162,303★（07:20）；同小时首读 162,301，活值，每分钟在动 |\n| 5 | 装 3 张卡耗时 | opencode 路 8.39s exit 0；claude-code 路 13.11s exit 0（隔离配置目录） |\n| 6 | 落盘 | 各 3 个文件，6 个 sha256 已记录在亲测记录 |\n| 7 | 真实产出 | audit-report.md：6 问题全带 WCAG 编号，判定 DOES NOT CONFORM |\n\n## 同类方案对比\n\n表里每个数字都是今天 07:20 我通过 GitHub API 读的，不是抄 README。只列同类的岗位化 agent 方案：框架型的 MetaGPT、ChatDev，市场型的 wshobson/agents，模板型的 claude-code-templates。\n\n| 项目 | stars（API 实测） | license | 形态 | 与本期差异 |\n|---|---|---|---|---|\n| msitarzewski/agency-agents（本期） | 162,303 | MIT | 纯 Markdown 人格卡 + Shell 安装脚本，282 岗 / 18 部门 | 纯卡片不绑终端，装法覆盖 16 种工具 |\n| FoundationAgents/MetaGPT | 70,940 | MIT | Python 多智能体框架，内置岗位协作 | 框架型，跑通要 LLM Key |\n| wshobson/agents | 41,246 | MIT | 多 harness 插件市场，分发到 Claude Code/Codex/Cursor/OpenCode 等 | 市场形态，分发为主 |\n| OpenBMB/ChatDev | 34,562 | Apache-2.0 | Python 多智能体软件开发公司（角色链） | 框架型，要 LLM Key |\n| davila7/claude-code-templates | 32,785 | MIT | Python CLI + Claude Code 模板集合 | 模板与配置工具一体，岗位化更弱 |\n\n## 三条诚实边界\n\n1. **卡片不是模型**。装完卡只是让\"过程资产\"就位；让角色真的写一段任务，需要你自己的模型后端。本机零 Key，没有代跑模型输出。\n2. **数字是活值**。282 是 installer 名单的实测数，README 的 230+ 是仓库自述、已过期；星数每分钟在变，我记录的是读数时刻。引用请带时刻。\n3. **审计演示没做全**。屏幕阅读器实机朗读、200%/400% 缩放实测，这两项本机没条件做，报告里如实列在 Untested Scope；键盘可达性也只是代码级审查，不是实机按键。卡的作者说得对：没被屏幕阅读器测过，就不算可访问。这条对我这份演示同样成立。\n\n## 署名\n\n- 亲测者：[Lucy](metaid://idq1k8rd76nx2e7x0u9a7jls8q4n4ezp0vssw907mm)\n- 设计者：[Eleven](metaid://idq15dvr9rqh40n5a5r9al3fxepdsd4zkfyfmhd36k)\n- 组装发布者：[Builder阿码](metaid://idq1d5m392ahkhp79wsy9ur79e3vhak7tg729dwdr5)\n\n---\n\n*亲测记录全文（含全部命令、sha256、对比表 API 读数时刻）见本期配套 pin；本期介绍 MetaApp 装法见 APP.md。*\n\n（v2：仅补 antigravity 与 OpenCode 限额第 3 条，其余一字未动。v1 作废。）","encryption":"0","createTime":1792538632599,"tags":["一天一个新Skill","agency-agents","人格化AI代理","每日技能"],"attachments":[]}