智能体
dev.to ·
@Constantine Macris
你大概不需要 264 个 AI agent
文章对 Agency Agents 仓库(264 个专用 agent 定义、支持多种编码 harness、作者审查时约 15.1 万 GitHub star)做源码审查,明确声明这不是基准测试,仅检查了角色文件、安装器、转换器、贡献规则、工作流示例和 GitHub 检查。作者认为仓库提供的是 MIT 许可的角色库和安装器,不能证明更大虚拟团队产出更好;角色提示不带来进程隔离,若 reviewer 与实现者共享凭证和写权限,标签只是表面功夫;建议采用一个可写实现者加两个只读审查者的最小角色组合,并让输出通过真实检查。
AI推荐理由 作者声明这是对 Agency Agents 仓库 commit 6d29a9b 的源码审查而非基准测试,检查了角色文件、安装器、转换器、贡献规则、工作流示例和 GitHub 检查,未评估全部集成与桌面应用。文章给出具体判断:264 个 agent 定义与约 15.1 万 star 不能证明更大虚拟团队产出更好;角色提示不构成进程隔离,同一凭证与写权限会让 reviewer 标签形同虚设;并建议一写两读的三角色最小方案。有明确证据边界,但作者披露自家产品 Software Sausage,且 star 数不能证明工具实际效果。
70
正文
Disclosure: Software Sausage is our product. Agency Agents did not sponsor, review, or endorse this article. AI tools helped draft and edit it; the evidence boundary is stated below.
You probably do not need 264 AI agents. You need bounded roles and a gate
The Agency Agents repository is difficult to ignore: 264 specialized agent definitions, broad coding-harness support, and—when I reviewed it on September 9, 2026—roughly 151,000 GitHub stars.
The tempting conclusion is that a larger virtual team produces better work.
The repository does not establish that. What it does provide is a useful, MIT-licensed role library and a competent installer. The value comes from selecting a few narrow roles and making their outputs pass real checks.
This is a source review at commit 6d29a9b, not a benchmark. I inspected the role files, installer, converter, contribution rules, workflow example, and current GitHub checks. I did not evaluate every integration or the desktop app.
What it gets right
Agent definitions are not one-line personas. They name deliverables, workflows, constraints, and success metrics. The project converts them for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Qwen Code, Aider, and other harnesses.
More importantly, the installer lets you select one role or division, show a dry run, and target an explicit path. Agency Agents itself warns that OpenCode currently registers only about 119 agents and recommends installing a subset.
The project's contribution guide contains the best design rule: a new agent needs a narrow specialization, distinct behavior, concrete deliverables, measurable success, and real testing. Near-duplicate re-skins are rejected.
That rule should apply to the workflow too. If two roles produce the same artifact, if nobody consumes an output, or if success cannot be checked, remove the role.
What it does not prove
The README's “never sleep” and “always deliver” language is marketing. Prompts still fail, time out, overrun context, and agree on the same plausible mistake.
A role prompt also does not create process isolation. Giving a “reviewer” the same credentials and write access as the implementer makes the label cosmetic.
The repository's seven-agent startup example recommends passing full outputs between roles. Its newer Multi-Agent Systems Architect warns about context growth and recommends summaries and structured state. Use the second rule.
Green installer and manifest checks show that the repository is maintained and internally consistent. They do not show that seven agents outperform one capable agent on correctness, elapsed time, or cost.
Recipe one: one writer, two read-only reviewers
For a software change, three responsibilities are enough:
The Minimal Change Engineer receives one outcome, explicit exclusions, allowed files, and an acceptance command. It can write code but cannot deploy.
The Code Reviewer receives the task, diff, and check log with read-only access. It separates blockers, suggestions, and nits.
The AI-Generated Code Security Auditor receives the same evidence plus the relevant trust boundaries. It uses local, read-only checks and records evidence for each finding.
The implementer gets at most two corrections. Then a person resolves the findings, reruns the repository checks, captures fresh runtime proof, and decides whether to ship.
The free three-agent code-change kit includes the handoff ledger and verifier.
Recipe two: make multi-agent earn its keep
If the question is whether orchestration helps, compare it with one agent:
Freeze a resettable task and choose correctness, cost, latency, intervention, safety, and privacy thresholds before the run.
Run one agent with the model, budget, tools, permissions, and fixture recorded.
Let the architect choose no more than three challenger roles. Define each input, output, permission, fallback, one human gate, and a two-retry cap.
Run the challenger on an identical fresh fixture. Pass agreed artifacts and summaries, not accumulated chat transcripts.
Apply the same deterministic verifier and blind rubric to both results.
Keep orchestration only when it clears the predeclared threshold. Retain failed and stopped runs.
The free multi-agent experiment kit provides the comparison manifest.
The useful default
Start with one agent. Add one role only when it owns a distinct artifact with a consumer and an acceptance check. Keep permissions separate. Cap retries. Leave the human at the irreversible boundary.
Agency Agents makes roles easy to install. The harder—and more valuable—work is proving which ones deserve to stay.
The complete source review and both pullable kits are at Software Sausage. The public Software Sausage MCP endpoint can also find these recipes and return their complete run ledgers inside a compatible agent client.