使用说明
新鲜的
一个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/<slug>.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。证明可开发性；不要碰任何修理。 |
船
| 代理 | 焦点 |
|---|---|
github-manager |
承诺、分支机构、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）；看见 block.github.io/goose 对于其他平台。 |
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.
