module6
60 分钟

团队工具链搭建

学习进度

当前模块0/6 课
总进度0/36 课
学习时长0 分钟

学习目标

  • 制定团队工具选型策略
  • 搭建统一的开发环境和配置
  • 建立共享的 Codex 指令模板库
  • 设计新成员入职培训计划

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 — 编码规范制定

下一模块