新鲜的
一个Claude Code插件,可以将一个聊天变成一个14个代理的开发团队。一个斜线命令-- /buddy --解析您的请求,预览计划,并通过内置的 task-tracker MCP。国家生活在 .dev-team/tasks.json 在您的repo中。没有数据库,没有云,没有外部服务。
状态: v0.2.1预览版。修复了市场可发现性和命名空间 task-tracker MCP工具名称如下 /buddy 实际上可以接触到他们。同样在0.2.x中:计划预览和批准入口 /buddy,自动识别 .dev-team/,以及下面的14名特工阵容。
为什么/为什么不
在以下情况下使用此功能 您希望在一次聊天中保留一个功能或错误,但仍然将产品、设计、实现、QA、安全性和PR分开。 /buddy 进行路由;在任何事情开始之前,你都要专注于一个线程并审查一个计划。
跳过此项 你已经有了一个你信任的项目管理系统,你正在做一个不需要多步DAG的单行程序,或者你需要磁盘上JSON文件之外的可观察性。没有仪表板,没有队列,没有远程运行器——只有子代理、一个MCP和一个文件。
快速入门
# 1. Add the marketplace and install (one-time per machine)
claude plugin marketplace add RohiRIK/dev-team
claude plugin install dev-team
# 2. Open any project in Claude Code
/buddy add a /health endpoint that returns {status:"ok"}预期产量-- /buddy 呈现计划表并等待批准:
Planned dispatch for: "add a /health endpoint that returns {status:'ok'}"
| # | Agent | Task | Depends on |
|---|--------------------|--------------------------------------------|------------|
| 1 | backend-developer | Add GET /health returning {status:'ok'} | — |
| 2 | qa-tester | Regression test for /health | 1 |
| 3 | github-manager | Commit + PR /health | 2 |
Routing confidence: high — clear backend endpoint signal.
Security gate: not needed — no auth / input / secret / external-data surface.
Reply "go" to dispatch, or describe changes (swap agents, drop steps, reorder).回复 go 和 /buddy 创建任务,分派代理,并在每个任务处于终端状态时报告。任务状态被写入 .dev-team/tasks.json,自动添加到 .gitignore 第一次写作。
从源代码安装
git clone https://github.com/RohiRIK/dev-team.git
cd dev-team
bun install
claude --plugin-dir .如何 /buddy 作品
/buddy 他是一个协调者,而不是一个工人。每次调用都经过同一扇门:
- 解析 使用路由矩阵来决定单代理还是多步DAG。
- 预览 将整个计划作为表格(如上所示)并停止。尚未创建任务。
- 批准或修订。 回复
go发送。回复更改(交换代理、删除步骤、重新排序、缩小范围)和/buddy重新呈现整个计划。回复cancel在未创建任务的情况下中止。 - 派遣 —
create_task对于每一步,然后Task按依赖顺序调用工具。在deps允许的情况下并行。 - 观看+结束 --每个代理都通过
task-trackerMCP。当所有任务都结束时,/buddy发布每个代理的摘要和路由置信线。
单代理请求仍显示单行预览,仍在等待批准。完整的路由矩阵、模糊连接断路器、拒绝规则和三个工作示例 commands/buddy.md.
内部是什么——14个代理,五个生命周期阶段
每个代理都附带一个范围化的工具分配列表(默认拒绝)和一个规范的7节正文(角色、何时使用、何时不使用、工作流、工具、约束、已处理示例)。完整规格 agents/.md.
定义
| 代理 | 焦点 |
|---|---|
product-manager | PRD、用户故事、路线图、优先级——只有规格,从不编码。 |
设计
| 代理 | 焦点 |
|---|---|
system-architect | 系统设计、ADR、C4图、服务分解——仅限设计。 |
cloud-architect | 云拓扑、区域/区域/网络选择、IaC计划、成本和HA/DR模型——计划永远不会执行。 |
ui-ux-designer | 流程、线框、设计系统令牌、可访问性审计、Figma切换——没有可运行的代码。 |
构建
| 代理 | 焦点 |
|---|---|
backend-developer | REST/GraphQL API、服务器端逻辑、后台作业、Bun迁移——完整实现→ test → 文档循环。 |
frontend-developer | React/Next.js组件、页面、客户端状态、Tailwind/CSS、组件测试。 |
database-admin | 架构、迁移、索引/查询调优、备份/还原、副本。拥有数据层。 |
ml-engineer | 数据管道、模型训练/评估/部署、实验跟踪、生产漂移监测 |
devops-engineer | 执行云架构师计划:CI、容器构建、Kubernetes、运行时环境、部署调试。 |
审查
| 代理 | 焦点 |
|---|---|
qa-tester | E2E/集成/回归测试、bug修复验证、薄片分类。编辑测试;从不编写prod代码。 |
security-analyst | 防御审查——OWASP、authz、秘密/dep扫描、威胁模型、云态势审计。只做复习,不做任何修改。 |
pentester | 授权进攻PoCs——nmap、burp、sqlmap、nuclears。证明可开发性;不要碰任何修理。 |
船
| 代理 | 焦点 |
|---|---|
承诺、分支机构、PR、发布卫生、发布, gh CLI。每个开发链都在这里终止。 |
元
| 代理 | 焦点 |
|---|---|
agent-builder | 脚手架、端口和验证开发团队子代理通过 create-agent 技能。用于添加或刷新代理。 |
先决条件
代理支持Bash,但本身不安装CLI。安装您使用的代理实际需要的那些——插件本身不需要全局安装。
根据代理人CLIs
| 代理人 | CLIs |
|---|---|
backend-developer | bun, bunx, uv, uvx, curl, jq |
frontend-developer | bun, bunx, vite, playwright |
database-admin | psql, sqlite3, drizzle-kit / prisma |
devops-engineer | docker, docker-compose, kubectl, helm, gh |
cloud-architect | terraform, aws, gcloud, az |
qa-tester | playwright, vitest, bun test, pytest |
security-analyst | bunx varlock, trivy, semgrep, gitleaks |
pentester | nmap, nikto, ffuf *(仅限授权测试)* |
ml-engineer | uv, python, jupyter |
ui-ux-designer | *没有Bash--没有CLI deps* |
github-manager | gh, git |
product-manager | *没有Bash--没有CLI deps* |
agent-builder | bun, bunx |
system-architect | *没有Bash--没有CLI deps* |
包管理器首选项
- 节点生态系统 →
bun/bunx(从来没有npm,npx,yarn,pnpm). - Python生态系统 →
uv/uvx(从来没有pip,pipx,poetry). - JSON读取 →
jq(从来没有python3 -c 'import json...').
_本节由以下内容生成 scripts/gen-prereqs.ts.编辑脚本 PER_AGENT_CLIS 表并重新运行以进行更新。_
每台发动机CLIs(可选,alpha)
/buddy 可以将单个任务路由到外部CLI引擎,而不是在Claude下的会话中运行它们。通过以下方式选择加入 DEV_TEAM_MULTI_ENGINE=1;未设置标志时,每个任务都会继续运行 claude 并且发动机列在平面预览中隐藏。只安装您实际计划路由到的引擎——不需要任何引擎。
| 引擎 | CLI | 描述 | 安装提示 |
|---|---|---|---|
gemini-cli | gemini | Google Gemini CLI——长上下文任务,廉价令牌工作负载。 | bun add -g @google/gemini-cli (或遵循上游回购) |
opencode | opencode | OpenCode终端代理——用于本地路由的Claude Code的开源替代方案。 | 请参阅 opencode.ai 对于特定于平台的二进制文件。 |
goose | goose | 布洛克的鹅特工——自主的本地首次执行。 | brew install block-goose-cli (macOS);看见 对于其他平台。 |
minimax-cli | minimax | MiniMax CLI——替代模型提供程序。 | 按照MiniMax CLI安装说明进行操作。 |
aider | aider | 助手——结对编程CLI;支持 --message-file 无头调度。 | pipx install aider-chat (或 uv tool install aider-chat). |
github-copilot | gh copilot | GitHub Copilot CLI子命令——最适合shell建议任务,对完整代理运行进行实验。 | 然后安装GitHub CLI gh extension install github/gh-copilot. |
codex | codex | OpenAI Codex CLI——代理编码 codex exec --full-auto. | 有关安装命令,请参阅OpenAI的Codex CLI发行说明。 |
cursor-agent | cursor-agent | 游标无头代理CLI。 | 请参阅 cursor.com 下载无头代理。 |
pi | pi | Pi by拐点——对话式;不太适合编码代理。包括完整性。 | 顺着上游走 pi CLI安装说明。 |
当发动机的二进制文件缺失时 PATH 在预览时, /buddy 将行重写为 claude (fallback) 所以你批准了实际的路由——调度永远不会在之后默默地交换引擎 go。登记处位于 state/engines.json;要添加新引擎,请在那里添加一行并重新运行 bun scripts/verify-agents.ts.每个代理人的同族成员住在每个代理人的 engines: 正面。
检查安装了什么: 跑 bun scripts/engines-doctor.ts 通过以下方式探测每个发动机的二进制文件 PATH 并每行打印一行状态。添加 --json 用于机器可读输出。仅当没有引擎解析时退出非零。
_Per engine CLIs表是手工编辑的; scripts/gen-prereqs.ts 只拥有上面的每个代理块。注册表更改时更新此表。_
状态
任务状态位于 ${CLAUDE_PROJECT_DIR}/.dev-team/tasks.json --每个工作区一个JSON文件。这 task-tracker MCP以原子方式读写(fs.rename 具有用于网络/云同步文件系统的跨设备回退)。没有数据库服务器,没有云调用。
在第一次任务保存时,MCP会添加 .dev-team/ 到回购 .gitignore --幂等且静默,仅当工作区位于git仓库内时。在git repo之外(例如。 /tmp),什么都不写 .gitignore 并且状态仍然正常。
故障排除
/buddy 未出现在斜线命令列表中
插件已注册,但命令尚不可见。在Claude Code中,运行:
/reload-plugins然后键入 / — /buddy 应该出现。如果仍然没有,请使用确认安装 /plugin list 并重新安装: claude plugin uninstall dev-team && claude plugin install dev-team.
/plugin update 挂起或返回“已更新”,但您仍使用旧版本
0.2.1之前的版本发布了非规范版本 source 市场中的字段清单阻止了 /plugin update 从解决。修复:
claude plugin marketplace remove RohiRIK/dev-team
claude plugin marketplace add RohiRIK/dev-team
claude plugin install dev-team这使市场准入相对于0.2.1+和未来重新水合 /plugin update 通话将正常进行。
卸载
claude plugin uninstall dev-team
claude plugin marketplace remove RohiRIK/dev-team # optional — removes the marketplace registration too任务状态在 .dev-team/tasks.json 每个工作区都有,卸载时不会触及。如果你想重新开始,请手动删除它。
文档
docs/architecture.md--如何/buddy,thetask-trackerMCP和试剂连接在一起。docs/agents.md--完整的代理规格、工具配置列表和规范的7段形状。docs/task-tracker.md--MCP工具参考(create_task,update_task,complete_task,list_tasks,get_task).docs/development.md--本地开发、验证脚本、发布过程。
限制(v0.2.x)
- 每个工作区一个会话。 并发
/buddy在同一工作区中运行可以进行比赛;每次保持一个。 - 路由是基于关键字的,而不是模型驱动。弱匹配被标记为对计划预览的信心低;反馈被捕获在
state/routing-feedback.jsonl. - 没有内置的可观察性UI。 阅读
.dev-team/tasks.json直接,或问/buddy查看状态摘要。 - 只有
task-trackerMCP船。 代理可以使用任何用户注册的MCP,但插件本身仅取决于捆绑的服务器。
发展
bun install # dependencies
bun scripts/verify-agents.ts # lint agents (strict — fails on TODO markers)
bun scripts/verify-agents.ts --skills # lint skills
bun test # run task-tracker MCP tests
bun scripts/gen-prereqs.ts # regenerate the Prerequisites block
bun scripts/gen-prereqs.ts --check # fail CI if the README block drifted典型试剂形状: skills/create-agent/references/agent-structure.md.
许可证
麻省理工学院——见 LICENSE.
