Claude Code Sub-Agent Collective

为 Claude Code 安装 30+ 个强制 TDD 流程的专项子代理,通过中心路由与上下文工程加速原型开发。

Star 数
★ 526
最近更新
7 个月前
License
MIT
主语言
JavaScript

30 秒速览

可在哪里用
平台专用Claude Code
开始前需要
Node.js >= 16.0.0NPM >= 8.0.0支持 MCP 与 hook 系统的 Claude CodeContext7Shell / 命令行网络访问本地文件系统MCP Server
典型场景
独立开发者快速搭建 MVP,希望每个功能自带测试而非事后补写
主要局限
实验性项目,作者自述部分代理仍在打磨、研究阶段可能很慢
维护状态
超过半年没有提交最近提交 2026-04-20

这个 Agent 能做什么,适合哪些场景?

这是 vanzan01 开发的实验性个人项目,通过 npm 包 claude-code-collective 向 Claude Code 项目安装一套 AI 子代理集合。安装后项目内会生成 CLAUDE.md 行为规则、.claude/agents/ 下的 30+ 个代理定义、.claude/hooks/ 中的 TDD 强制脚本以及 .claude-collective/ 下的 Vitest 测试框架。其架构采用轴辐(hub-and-spoke)模式:/van 命令把请求路由到 @task-orchestrator,由它分析复杂度并分派给实现、测试、质量、运维等专项代理。所有实现代理遵守 RED → GREEN → REFACTOR 的 TDD 契约,并通过 Context7 拉取真实的库文档而非凭空猜测 API。作者明确声明这是有强烈观点的实验性工具,适合快速构建 MVP,而非生产级企业软件。

运行 npx claude-code-collective init 后,工具会在你的项目中写入 CLAUDE.md 行为规则、settings.json hook 配置、30+ 个代理定义文件(如 prd-research-agent.md、task-orchestrator.md)、lib/research-analyzer.js 复杂度分析引擎,以及 test-driven-handoff.sh、collective-metrics.sh 等 hook 脚本。工作时,/van 命令将请求交给 @task-orchestrator,后者用 ResearchDrivenAnalyzer 评估复杂度,把任务并行分派给 @component-implementation-agent、@feature-implementation-agent、@testing-implementation-agent 等专项代理。代理先用 Context7 查询真实文档,再先写测试(RED)、实现最少代码使测试通过(GREEN)、重构(REFACTOR),最终输出包含测试结果的标准化 DELIVERY COMPLETE 报告。@functional-testing-agent 使用 Playwright 做浏览器测试,@quality-agent 和 @enhanced-quality-gate、@completion-gate 在标准未达标前阻止任务完成。配套的 status、validate、repair、clean 子命令用于检查、校验、修复和卸载安装。

  1. 独立开发者快速搭建 MVP,希望每个功能自带测试而非事后补写
  2. 经常需要查阅库文档的 Claude Code 用户,想让代理用 Context7 读真实文档而不是猜测 API
  3. 复杂特性需要拆解并并行分派给不同专项代理的团队
  4. 希望用 hook 机制强制执行 TDD 流程、防止代理跳过测试的项目
  5. 需要对 React 等 UI 组件做 Playwright 浏览器级功能测试的工作流

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npx claude-code-collective init
  • npx claude-code-collective init --minimal
  • npx claude-code-collective init --testing-only
  • npx claude-code-collective init --hooks-only
运行环境
Node.js 16.0.0+

如何安装或部署这个 Agent?

需要 Node.js >= 16.0.0、NPM >= 8.0.0 以及支持 MCP 和 hook 的 Claude Code。

npx claude-code-collective init

可选的精简安装方式:

npx claude-code-collective init --minimal
npx claude-code-collective init --testing-only
npx claude-code-collective init --hooks-only
npx claude-code-collective init --interactive

安装后必须重启 Claude Code,hook 才能加载。

如何使用这个 Agent?

在 Claude Code 中输入 /van 启动流程,例如请求"Build a simple todo app with React"。预期流程:路由到研究阶段 → 拆解任务 → 先写测试 → 实现。日常管理命令:

npx claude-code-collective status
npx claude-code-collective validate
npx claude-code-collective repair
npx claude-code-collective clean

如安装失败,可检查 node --version、清理 npm 缓存,或使用 --force 强制安装。

这个 Agent 有哪些优点和局限?

优点
  • hook 系统在写代码前强制 TDD,从机制上阻止代理跳过测试
  • Context7 集成让代理使用真实、当前的库文档而非编造 API
  • 轴辐式 @task-orchestrator 中央路由避免代理自行选错方向和点对点沟通混乱
  • 提供 validate、repair、clean 等完整的安装生命周期管理命令
局限
  • 实验性项目,作者自述部分代理仍在打磨、研究阶段可能很慢
  • 深度绑定 Claude Code 的 hook 与 MCP 机制,安装后必须重启 Claude Code
  • 强烈倾向 TDD,不做测试优先的团队不适合
  • 文档分散在多个文件中,排查问题成本较高

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Claude Code Sub-Agent Collective 当前 56 · 缺口较多 — ★ 526 7 个月前 JavaScript Claude Code
Ordewell 87 · 表现良好 命令行工具免费 + 模型费 ★ 212 今天 TypeScript Codex · Claude Code · OpenAI API · Claude API
PowerContext 82 · 表现良好 命令行工具免费 ★ 1.8k 今天 Python Codex · Claude Code
Agent 设计模式(ADPS) 72 · 存在缺口 代码库 / SDK免费 ★ 353 4 天前 HTML —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
56/ 100 五分制 2.8 / 5
信任安全 11/29
可靠稳定 8/14
适用触发 12/18
规范维护 14/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

安装器会向用户项目写入 .claude/settings.json、30+ 个 agent 定义和 hook 脚本,hook 强制改变项目行为,属于较宽的影响面;除交互式 init 外未见对 hook 注入、指标采集的明确用户确认;指标写入 .claude-collective/metrics 属本地采集但未说明保存哪些任务数据、如何清理;依赖均为常见包但仅用 caret 范围、无审计或锁定证据;安装涉及 Context7 网络调用与文件写入,外部影响有描述但无最小化设计;正向点是 clean/repair/validate 命令提供安装级回滚(得 2);扣分点是 package.json 的 repository URL 指向 anthropics/claude-code-sub-agent-collective,与实际 GitHub 仓库 (vanzan01) 不符,来源归属失实。

可靠稳定8 / 14 · 2.9/5

自相矛盾:README 称 @task-orchestrator 为路由中枢,CLAUDE.md 却称 hub-and-spoke 以 @routing-agent 为中心协调者,二者不一致(扣分);依赖 Node>=16、npm>=8,Context7 为外部服务且文档承认可能连通性失败(2);故障信息较好:validate/status/repair 诊断、troubleshooting 章节覆盖安装失败、hook 不加载、测试不运行等场景(2)。

适用触发12 / 18 · 3.3/5

受众明确(个人 MVP/原型开发、TDD 偏好者)并给出 --minimal 等安装选项(2);'What it is and isn't' 与 honest assessment 章节把能力边界讲得很清楚,得 3;触发精度弱:路由'usually picks the right agent'仅是经验性说法,无路由规则或精度证据(1);环境要求(Node 版本、重启要求、MCP/hook 支持)有明确说明但 hook 需重启属脆弱点(2)。

规范维护14 / 18 · 3.9/5

README 自认 'Documentation is scattered across files',信息架构散乱(1);安装说明非常完整,含选项、安装产物清单、验证步骤(3);命名总体一致(@agent 前缀、ccc-* 测试目录规范),但 agent 命名在文档间有出入(2);命令文档示例丰富但 FAQ 偏 troubleshooting(2);已知限制章节诚实详尽(3);MIT LICENSE 文件完整且与元数据一致(3);版本 2.0.8 且 CHANGELOG 被引用但内容未在证据中(2);维护者明示为副业项目、响应慢,责任边界清楚但持续维护无保证(2)。

有效结果7 / 13 · 2.7/5

输出有标准化 TDD 完成报告与质量门禁,可用性尚可(2);对 TDD 工作流的边际价值真实存在(测试先行、Context7 文档检索),但核心研究假设(H1/H2/H3)仅有目标阈值、无验证结果发布(2);成本收益偏弱:30+ agent 全量安装、自认'some agents might be too thorough/slow'、研究阶段可能很慢,轻量任务的开销偏大(1)。

证据核验4 / 8 · 2.5/5

性能声明(简单命令 <50ms 等)与研究目标(30% 上下文削减等)均为断言,无测量数据支撑(1);文档间交叉印证失败(中枢 agent 名称矛盾、package.json 仓库 URL 错误),削弱了内部一致性印证(1);正面点是项目反复明确标注 experimental、个人项目、'use at your own risk',事实与推断区分做得较好(2)。

风险与缓解建议
  • package.json 中的 repository URL 指向 anthropics 组织,与实际仓库 vanzan01/claude-code-sub-agent-collective 不符,来源归属信息不可信,使用前请自行核对。
  • 安装会向你的项目写入 .claude/settings.json 与 hook 脚本,改变 Claude Code 行为;安装前应检查 hook 内容,并知晓需重启 Claude Code。
  • 指标系统会在 .claude-collective/metrics 下记录使用数据,未说明数据范围与清理方式,注意任务内容可能被写入本地文件。
  • README 与 CLAUDE.md 对中枢 agent 的描述互相矛盾(task-orchestrator vs routing-agent),实际行为以运行结果为准。
  • 研究性性能声明与研究假设均未附验证数据,不应视为已证实的收益。
  • 仅适合原型/个人项目场景;作者明示非生产就绪、维护响应慢,不要用于有安全或稳定性要求的环境。
证据充分度:低 评估于 2026年11月22日 审查版本 ab766205f522
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/claude-code-sub-agent-collective.svg?lang=zh)](https://followagents.com/zh/agents/claude-code-sub-agent-collective)
<a href="https://followagents.com/zh/agents/claude-code-sub-agent-collective"><img src="https://followagents.com/badge/claude-code-sub-agent-collective.svg?lang=zh" alt="FARS 评测"></a>

常见问题

Claude Code Sub-Agent Collective 开源吗?
开源。源码在 GitHub(vanzan01/claude-code-sub-agent-collective),许可证是 MIT。
Claude Code Sub-Agent Collective 安全吗?
FollowAgents 的 FARS 评审(2026年11月22日)给 Claude Code Sub-Agent Collective 的“信任与安全”打了 11/29 分。评审检查的 8 项安全措施没有完全缺失的。
Claude Code Sub-Agent Collective 还在维护吗?
GitHub 仓库自 2026-04-20 以来没有新提交,已超过半年。可能是项目已经完成,也可能已经停更,用之前建议先看看 issue 区。
Claude Code Sub-Agent Collective 是谁开发的?
Claude Code Sub-Agent Collective 由 GitHub 账号 vanzan01 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念