团队协作规范¶
把个人 Vibe Coding 实践升级为团队标准,让整个团队都能稳定交付。
团队规范体系¶
graph TD
A[个人实践] --> B[团队规范]
B --> C[项目规则文件]
B --> D[提示词模板库]
B --> E[验收标准清单]
B --> F[复盘机制]
项目规则文件¶
每个项目维护一个 .trae/rules/project_rules.md,包含:
# [项目名] Vibe Coding 规则
## 技术栈
[列出所有主要依赖和版本]
## 目录结构约定
[说明各目录的职责和边界]
## 代码约定
[命名规范、文件组织、注释要求]
## 禁止事项
[明确列出不允许 AI 做的事情]
## 验收标准
[每次任务完成后必须运行的命令]
## 常见陷阱
[本项目中 AI 容易犯的错误]
提示词模板库管理¶
模板分级¶
| 级别 | 说明 | 维护方式 |
|---|---|---|
| 通用模板 | 跨项目可用 | 团队 Wiki |
| 项目模板 | 项目特定约定 | 项目仓库 |
| 个人模板 | 个人习惯 | 个人笔记 |
模板评审流程¶
- 开发者提交新模板到团队 Wiki
- 至少 2 人在实际任务中验证
- 记录验证结果和适用场景
- 正式纳入团队模板库
Code Review 规范¶
AI 生成代码的额外检查项¶
在常规 Code Review 基础上,增加:
- 代码是否与项目架构约定一致
- 是否引入了不在
package.json中的依赖 - 错误处理是否完整(AI 容易遗漏边界情况)
- 安全敏感逻辑是否经过人工深度审查
- 测试覆盖率是否满足要求
PR 描述模板¶
## 变更摘要
[简述做了什么]
## AI 协作说明
- 使用的提示词模板:[模板名称]
- AI 生成的部分:[列出 AI 生成的文件/函数]
- 人工修改的部分:[列出人工调整的内容]
## 验证结果
- [ ] 单元测试通过:`[测试命令]`
- [ ] 类型检查通过:`[类型检查命令]`
- [ ] 构建成功:`[构建命令]`
- [ ] 手动验收:[验收步骤]
## 残余风险
[列出未覆盖的边界情况或已知限制]
团队复盘机制¶
每周 Vibe Coding 分享(15 分钟)¶
- 本周最有效的提示词模式
- 本周遇到的 AI 失败案例和解决方法
- 新发现的工具或技巧
月度模板库更新¶
- 收集本月的有效模板
- 淘汰效果不好的模板
- 更新项目规则文件
新人入职指南¶
新成员加入团队后的 Vibe Coding 上手路径:
- 阅读项目规则文件(
.trae/rules/project_rules.md) - 完成 3 个"带师傅"任务(有经验成员 Review)
- 独立完成 1 个小功能,提交 PR
- 参加第一次团队复盘分享
关键原则
团队规范不是限制,而是让每个人都能快速上手的加速器。规范应该随着团队实践不断演进,而不是一成不变。