Dev-Toolbelt/dev-team-agents
GitHub: Dev-Toolbelt/dev-team-agents
一个基于Claude Code的开发团队代理系统，用于自动化软件开发生命周期中的各种协作任务。
Stars: 0 | Forks: 0
# 开发团队代理
🇧🇷 [查看巴西葡萄牙语版本](README.pt-BR.md)
一个全球化的专业 Claude Code 代理和技能团队，专注于软件开发。技术栈无关、项目感知，并且由社区协作维护。
## 这是什么
一组 Claude Code 代理和技能，共同构成一个完整的软件开发团队。每个代理都有明确的角色、专业领域和工作流集成。它们与您的项目规则共存——项目规范始终优先。
17个代理覆盖了完整的开发生命周期：探索、设计、实现、质量关卡和文档。→ 查看完整的[代理参考](docs/agents.md)。
## 如何安装
### 前置条件
- **Claude Code** — 命令行工具、桌面应用或IDE扩展。在 [claude.ai/code](https://claude.ai/code) 安装。
- **Git** — 安装程序使用 `git rev-parse` 验证项目根目录。
- **curl** 或 **wget** — 用于下载发布压缩包。
### 安装（最新版本）
在您的**项目根目录**下运行：
```
curl -sSL https://raw.githubusercontent.com/Dev-Toolbelt/dev-team-agents/main/scripts/install.sh | bash
```
示例输出：
```
[dev-team-agents] Fetching latest release...
[dev-team-agents] Installing v1.2.0...
[dev-team-agents] Extracting to .claude/dev-team-agents/
[dev-team-agents] Creating symlinks...
[dev-team-agents] Configuring hooks in .claude/settings.json...
? Which language should agents use when talking to you? (BCP 47 tag, e.g. en, pt-BR, es) [en]:
[dev-team-agents] Done. Installed v1.2.0.
[dev-team-agents] Run: "Help me set up this project with dev-team-agents"
```
### 语言偏好
在安装过程中，安装程序会询问代理应使用哪种语言进行对话。文档（ADR、变更日志、代码注释）始终保留英文。可随时在 `.claude/user-data/preferences.json` 中更新：
```
{ "language": "pt-BR" }
```
常用值：`en` · `pt-BR` · `es` · `fr` · `de` · `ja` · `zh-CN`
## 入门指南
安装完成后，告诉Claude开始设置流程：
```
"Help me set up this project with dev-team-agents"
```
`setup-assistant` 将会：
1. **检测** 这是首次设置还是刷新 —— 并相应调整
2. **扫描** 现有文件（README, CLAUDE.md, 包清单, git历史）并总结发现
3. **询问** 这是何种类型的项目：从零开始的新项目、继承/未完成的项目、还是活跃系统的维护项目
4. **通过单次交互收集** 配置：是否需要测试、CI/CD平台、云提供商、问题跟踪器
5. **提出计划** 供您批准，然后才创建或修改任何内容
6. **在 `.claude/docs/` 中生成** 活动上下文文档（技术栈、架构、代码标准、待办索引），并向 `CLAUDE.md` 追加 `## dev-team-agents` 部分
7. **确认** 已配置的内容，并将您指向相关的工作流指南
完整的设置通常需要5-10分钟。在现有项目上重新运行会触发刷新模式 —— 读取自上次运行以来的git历史，并仅修补受影响的文档。
## 斜杠命令
安装后，`/devteam:` 命名空间下提供22个斜杠命令。每个命令会启动相应的代理，并将工作范围限定在当前git分支或工作树内。
| 命令 | 功能 |
|------|------|
| `/devteam:plan` | 规划 —— 软件架构师 + 产品分析师 + 数据库专家（相关时加上后端/前端/运维） |
| `/devteam:backend` | 后端实现 —— 后端开发工程师 + 数据库专家 → 后端测试专家 |
| `/devteam:frontend` | 前端实现 —— 前端开发工程师 + UI/UX设计师 → 前端测试专家 |
| `/devteam:mobile` | 移动端实现 —— 移动端开发工程师 + UI/UX设计师（相关时） |
| `/devteam:fullstack` | 全栈实现 —— 后端和前端团队并行工作 |
| `/devteam:design` | UI/UX设计 —— UI/UX设计师 |
| `/devteam:fix` | 修复缺陷 —— 相关开发者 → 测试专家 |
| `/devteam:refactor` | 重构 —— 软件架构师规划，然后开发者执行 |
| `/devteam:architect` | 架构决策和ADR —— 软件架构师 |
| `/devteam:review` | 代码审查 —— 代码审查员 + 软件架构师 + 安全专家 |
| `/devteam:qa` | 质量保证 —— QA专家 |
| `/devteam:security` | 安全审计 —— 安全专家 + 软件架构师 |
| `/devteam:dba` | 数据库工作 —— 数据库专家 + 软件架构师 |
| `/devteam:devops` | 基础设施 / CI/CD —— DevOps专家 |
| `/devteam:tester` | 仅测试 —— 后端测试专家 + 前端测试专家 |
| `/devteam:docs` | 文档编写 —— 技术文档工程师 |
| `/devteam:pr` | 拉取请求 —— 起草标题和描述，在创建前征求确认 |
| `/devteam:commit` | 提交 —— 读取暂存的更改，按层分组，编写并运行提交 |
| `/devteam:workflow-new` | 完整的新项目工作流 |
| `/devteam:workflow-maintenance` | 维护/功能演进工作流 |
| `/devteam:workflow-bugfix` | 完整的缺陷修复工作流 |
| `/devteam:workflow-inherited` | 继承项目入门工作流 |
| `/devteam:workflow-security-patch` | 安全补丁工作流 |
**使用示例：**
```
/devteam:plan add an export-to-PDF feature for the fueling report
/devteam:backend implement the PDF export endpoint
/devteam:review
/devteam:pr draft
```
## 如何使用代理
通过在与Claude的对话中命名角色来调用代理：
```
"As the product-analyst, analyze this PRD: [document]"
"As the software-architect, define the architecture for this project."
"As the backend-developer, implement [task]"
"As the code-reviewer, review the changes in [files]."
```
这适用于Claude Code CLI（`claude`）、桌面应用、[claude.ai/code](https://claude.ai/code) 网页应用以及IDE扩展（VS Code, JetBrains）。
**每个代理在执行任何操作前都会提交一个计划供您批准。** 您可以审阅、调整并批准 —— 然后开始执行。
## 工作流
| 工作流 | 命令 | 适用场景 |
|--------|------|----------|
| 新项目 | `/devteam:workflow-new` | 从零开始 |
| 继承项目 | `/devteam:workflow-inherited` | 接手未完成的工作 |
| 维护 | `/devteam:workflow-maintenance` | 活跃项目，持续任务 |
| 缺陷修复 | `/devteam:workflow-bugfix` | 隔离的缺陷 |
| 安全补丁 | `/devteam:workflow-security-patch` | 安全漏洞 |
| 重构 | `/devteam:refactor` | 计划内的代码结构调整 |
| 代码审查 | `/devteam:review` | 合并前的PR审查 |
完整的工作流分步指南位于 [`workflows/`](workflows/) 目录中。
## 提交安装内容
因为 `install.sh` 下载的是压缩包（不是git克隆），`.claude/dev-team-agents/` 目录下没有嵌套的 `.git` 文件夹。**直接提交它**，这样您的整个团队在 `git pull` 后就能获得这些代理：
```
git add .claude/dev-team-agents/ .claude/agents/ .claude/skills/ .claude/commands/ .claude/settings.json
git commit -m "chore: add dev-team-agents"
```
## 工作树隔离
所有编码代理在编辑任何文件前都会询问一次：
[问题内容保持原样，此处为占位]
答案通过 `.claude/.worktree-session` 在同一任务的所有代理间共享 —— 多代理工作流只会询问一次。如果选择“是”，代理会创建 `.worktrees///` 目录，所有工作都在其中进行。如果选择“否”，代理将在当前分支上工作。
## 代理记忆
代理在每个会话开始时没有之前会话的记忆。通过三种机制最小化上下文丢失：
- **会话摘要** —— 在任何文件发生更改的会话结束时，代理会将条目写入 `.claude/user-data/session-summary.md`。一个 `Stop` 钩子会自动强制执行此操作。
- **ADR（架构决策记录）** —— 重要且难以逆转的决策记录为架构决策记录，存放在 `.claude/docs/development/adrs/`。使用以下命令创建：`bash .claude/dev-team-agents/scripts/new-adr.sh "标题"`
- **项目上下文技能** —— 定义每个代理启动时遵循的上下文加载顺序，包括会话摘要和ADR索引。
## 共存与定制
开发团队代理是一个**基础层**。您项目自己的规范始终具有最高优先级：`CLAUDE.md` → `AGENTS.md` → `.agents/<agent-name>.md`。如果您的项目规定使用制表符，代理就会使用制表符。
**不要**修改 `.claude/dev-team-agents/` 内的文件 —— 更新时它们会被覆盖。请在项目层面进行覆盖：
```
.agents/backend-developer.md # per-agent override
CLAUDE.md # project-wide rules for all agents
.claude/docs/development/code-standards.md # code standards used by reviewers
```
## 故障排除
**代理未被Claude识别** —— 验证符号链接是否存在：`ls .claude/agents/dev-team/`。如果缺失，请从项目根目录重新运行安装程序。
**技能未加载** —— 检查 `.claude/skills/` 是否包含符号链接。重新运行安装程序以修复损坏的链接。
**更新检查钩子在每次工具调用时都触发** —— 检查 `.claude/user-data/.last-update-check` 是否是可写文件（不是目录），并且 `scripts/hooks/pre-tool-use/01-check-updates.sh` 是否可执行。
**`setup-assistant` 已运行，但 CLAUDE.md 中缺少 `## dev-team-agents` 部分** —— 告诉Claude：“作为 setup-assistant，CLAUDE.md 中缺少 dev-team-agents 部分 —— 请添加。”
**代理在没有先显示计划的情况下执行** —— 检查您的项目 CLAUDE.md 中是否有任何与计划模式冲突的指令。
## 匿名遥测
dev-team-agents 收集**匿名、聚合的使用数据**，以帮助我们了解哪些代理和命令最有价值。
**收集内容：** 代理/命令名称、安装和更新事件、会话计数、操作系统系列以及已安装版本。绝不收集代码、文件路径、项目名称或任何个人数据。
**随时可通过编辑 `.claude/user-data/preferences.json` 选择退出：**
```
{ "telemetry": false }
```
完整详情请见 [PRIVACY.md](PRIVACY.md)。
## 贡献指南
1. Fork 仓库
2. 创建分支：`fix/agent-name-improvement` 或 `feat/new-skill`
3. 遵循 `CLAUDE.md` 中的作者规范
4. 提交一个PR，清晰说明更改内容及原因
## 许可证
MIT</div><div><strong>标签：</strong>AI 代理, Claude 代码, CLI 工具, Git 集成, Linux 内核安全, 人工智能辅助, 代码审查, 代码生成, 全球团队, 团队协作, 多语言支持, 威胁情报, 安全测试, 安全测试框架, 安装部署, 开发效率, 开发者工具, 技术栈无关, 攻击性安全, 数据管道, 文档生成, 服务器监控, 渗透测试工具, 网络可观测性, 网络安全研究, 质量保证, 软件工程, 软件开发, 项目感知, 项目生命周期, 项目管理</div></article></div>
<!-- 人机验证 -->
<script>
(function () {
var base = (document.querySelector('base') && document.querySelector('base').getAttribute('href')) || '';
var path = base.replace(/\/?$/, '') + '/cap-wasm/cap_wasm.min.js';
window.CAP_CUSTOM_WASM_URL = new URL(path, window.location.href).href;
})();
</script>
</body>
</html>