501 团队工具链搭建
从个人使用到团队落地,构建统一的 Codex 开发环境
学习目标
完成本课程后,你将能够:
一、团队工具选型策略
工具链全景图
| 类别 | 工具 | 用途 | 选型要点 |
|---|---|---|---|
| AI 编程 | Codex CLI | 对话式开发 | 终端集成、开源友好 |
| AI 编辑器 | Cursor | 补全 + 内联编辑 | 与 Codex 互补 |
| 代码审查 | Codex `/review` | 自动审查 | 团队标准集成 |
| 测试生成 | Codex `/test` | 单测生成 | 覆盖率目标 |
| 文档生成 | Codex `/docs` | API 文档 | 保持同步 |
| 依赖管理 | Codex `/deps` | 安全更新 | 自动化 |
选型决策矩阵
评估维度(权重):
- 学习成本(20%)
- 与现有工具集成度(25%)
- 安全合规(30%)
- 价格/ROI(15%)
- 社区支持(10%)二、统一开发环境
环境标准化
/init 请为团队生成开发环境标准化配置:
- VS Code 推荐插件列表(extensions.json)
- 统一 ESLint + Prettier 配置
- Git Hooks 配置(Husky + lint-staged)
- 开发容器配置(devcontainer.json)共享 VS Code 配置
// .vscode/extensions.json
{
"recommendations": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode",
"bradlc.vscode-tailwindcss",
"prisma.prisma",
"ms-azuretools.vscode-docker",
"github.vscode-github-actions"
]
}DevContainer 配置
// .devcontainer/devcontainer.json
{
"name": "TaskFlow Dev",
"image": "mcr.microsoft.com/devcontainers/typescript-node:20",
"features": {
"ghcr.io/devcontainers/features/docker-in-docker:2": {},
"ghcr.io/devcontainers/features/github-cli:1": {}
},
"customizations": {
"vscode": {
"extensions": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode"
]
}
},
"postCreateCommand": "npm ci && npx prisma generate"
}三、共享指令模板库
建立团队模板仓库
模板库结构:
team-templates/
├── codex.yaml # 项目级规则配置
├── instructions/
│ ├── new-feature.md # 新功能开发模板
│ ├── bug-fix.md # Bug 修复模板
│ ├── code-review.md # 代码审查模板
│ └── refactor.md # 重构模板
├── prompts/
│ ├── api-generate.md # API 生成提示词
│ ├── component-create.md # 组件创建提示词
│ └── test-write.md # 测试编写提示词
└── docs/
└── onboarding.md # 新人入职指南模板示例:新功能开发
# instructions/new-feature.md
## 新功能开发指令模板
【项目】{project_name}
【功能】{feature_description}
【关联模块】{related_modules}
### 需求确认
请先确认以下需求理解是否正确:
1. {requirement_1}
2. {requirement_2}
### 开发任务
1. 生成 Prisma Schema 变更
2. 创建 API 路由和控制器
3. 编写业务逻辑 Service
4. 添加输入验证
5. 编写单元测试
6. 更新 API 文档
### 验收标准
- [ ] 所有测试通过
- [ ] API 文档同步更新
- [ ] 代码通过 ESLint 检查
- [ ] 无 TypeScript 错误模板示例:Bug 修复
# instructions/bug-fix.md
## Bug 修复指令模板
【Bug 编号】{issue_number}
【严重程度】{P0/P1/P2/P3}
【影响范围】{affected_modules}
### 复现步骤
1. {step_1}
2. {step_2}
### 期望行为
{expected_behavior}
### 实际行为
{actual_behavior}
### 修复任务
1. 定位根因
2. 编写修复代码
3. 添加回归测试
4. 验证修复
### 根因分析(事后填写)
{root_cause}四、新成员入职培训
四周培训计划
| 周次 | 主题 | 内容 | 产出 |
|---|---|---|---|
| W1 | 环境与工具 | 搭建环境、学习 Codex 基础 | 可运行的项目 |
| W2 | 独立开发 | 用 Codex 完成简单功能 | 1 个 PR 合入 |
| W3 | 协作开发 | 代码审查、团队规范 | 3 个 PR 合入 |
| W4 | 独立负责 | 独立完成一个完整模块 | 模块上线 |
第一天清单
新成员第一天入职任务:
□ 安装 Node.js 20、Docker、VS Code
□ Clone 项目仓库
□ 运行 npm ci && npm run dev
□ 配置 Codex CLI
□ 学习 codex.yaml 中的项目规则
□ 用 /init 创建一个 Hello World 分支
□ 提交一个文档修改 PR
□ 与 Buddy 结对编程 30 分钟导师制度
Buddy 职责:
- 第一个月每日 15 分钟站会
- Code Review 前 10 个 PR
- 引导使用团队模板
- 解答 Codex 使用疑问
新人目标(首月):
- 至少 5 个 PR 被合入
- 掌握 5 个核心 / 命令
- 编写 1 篇内部分享文档五、持续优化机制
工具链迭代流程
收集反馈(每月)
→ 团队投票 Top 3 痛点
→ 试验新工具/新流程(2 周)
→ 评估效果
→ 纳入标准工具链反馈收集模板
## 月度工具链反馈
### Codex 使用频率
- [ ] 每天多次
- [ ] 每天一次
- [ ] 每周几次
- [ ] 很少使用
### 最常用的命令(多选)
- [ ] /init
- [ ] /review
- [ ] /test
- [ ] /debug
- [ ] /docs
- [ ] /refactor
### 最大痛点
{free_text}
### 希望新增的模板
{free_text}六、本课总结
**核心要点:**
- 工具选型不看单一维度,综合学习成本、集成度、安全合规、ROI
- DevContainer 确保所有成员开发环境一致,消除「我这儿能跑」问题
- 共享模板库是团队最核心的 AI 资产,降低每个人写好 Prompt 的门槛
- 入职培训要循序渐进,四周从环境到独立模块
- 工具链不是一成不变的,每月收集反馈,季度迭代
**下一步:** 模块 502 — 编码规范制定