Claude Code Sub-Agent Collective
为 Claude Code 安装 30+ 个强制 TDD 流程的专项子代理,通过中心路由与上下文工程加速原型开发。
- Star 数
- ★ 526
- 最近更新
- 7 个月前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用Claude Code
- 开始前需要
- 典型场景
- 独立开发者快速搭建 MVP,希望每个功能自带测试而非事后补写
- 主要局限
- 实验性项目,作者自述部分代理仍在打磨、研究阶段可能很慢
- 维护状态
- 超过半年没有提交最近提交 2026-04-20
- 源码审查
- 56/100 · 缺口较多
这个 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 子命令用于检查、校验、修复和卸载安装。
- 独立开发者快速搭建 MVP,希望每个功能自带测试而非事后补写
- 经常需要查阅库文档的 Claude Code 用户,想让代理用 Context7 读真实文档而不是猜测 API
- 复杂特性需要拆解并并行分派给不同专项代理的团队
- 希望用 hook 机制强制执行 TDD 流程、防止代理跳过测试的项目
- 需要对 React 等 UI 组件做 Playwright 浏览器级功能测试的工作流
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx claude-code-collective initnpx claude-code-collective init --minimalnpx claude-code-collective init --testing-onlynpx 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?
查看各维度的扣分理由
安装器会向用户项目写入 .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) 不符,来源归属失实。
自相矛盾:README 称 @task-orchestrator 为路由中枢,CLAUDE.md 却称 hub-and-spoke 以 @routing-agent 为中心协调者,二者不一致(扣分);依赖 Node>=16、npm>=8,Context7 为外部服务且文档承认可能连通性失败(2);故障信息较好:validate/status/repair 诊断、troubleshooting 章节覆盖安装失败、hook 不加载、测试不运行等场景(2)。
受众明确(个人 MVP/原型开发、TDD 偏好者)并给出 --minimal 等安装选项(2);'What it is and isn't' 与 honest assessment 章节把能力边界讲得很清楚,得 3;触发精度弱:路由'usually picks the right agent'仅是经验性说法,无路由规则或精度证据(1);环境要求(Node 版本、重启要求、MCP/hook 支持)有明确说明但 hook 需重启属脆弱点(2)。
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)。
输出有标准化 TDD 完成报告与质量门禁,可用性尚可(2);对 TDD 工作流的边际价值真实存在(测试先行、Context7 文档检索),但核心研究假设(H1/H2/H3)仅有目标阈值、无验证结果发布(2);成本收益偏弱:30+ agent 全量安装、自认'some agents might be too thorough/slow'、研究阶段可能很慢,轻量任务的开销偏大(1)。
性能声明(简单命令 <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),实际行为以运行结果为准。
- 研究性性能声明与研究假设均未附验证数据,不应视为已证实的收益。
- 仅适合原型/个人项目场景;作者明示非生产就绪、维护响应慢,不要用于有安全或稳定性要求的环境。
常见问题
Claude Code Sub-Agent Collective 开源吗?
Claude Code Sub-Agent Collective 安全吗?
Claude Code Sub-Agent Collective 还在维护吗?
Claude Code Sub-Agent Collective 是谁开发的?
谢谢反馈,我们会据此改进页面。