团队工作流

个人用 Copilot 补一行，与 团队统一 AI 规范 是两回事：PR 怎么标注、哪些目录可用 Agent、CodeRoadMap 讲义谁终审——需要写进 workflow，而不是默认「大家自觉」。

学习目标

• 设计可落地的团队 AI 使用规范要点
• 了解 PR 中标注 AI 辅助的常见做法
• 掌握 CodeRoadMap 内容从 outline 到 merge 的 responsible 流程

开发 PR 工作流

issue/需求 → feature 分支（git-branch）
          → 本地开发（Copilot 补全 + 可选 Cursor Agent）
          → 自测绿（testing-essentials）
          → PR：描述范围 + 是否 AI 辅助 + 测了什么
          → 人审 + CI
          → merge（git-merge）

PR 描述示例：

## Summary
- 新增 tracks 筛选 API

## AI usage
- Copilot：DTO 样板
- Cursor：Service 草稿，已改边界与测试

## Test plan
- [x] mvn test
- [x] MockMvc 新增 2 用例

标注 AI 不是免责，是 帮 reviewer 知道哪段多盯。

团队规范建议

主题	建议
允许工具	列明 Copilot / Cursor / 禁用云端
数据	禁止 secrets；客户数据脱敏
Agent	生产分支禁止自动 push；命令需批准
Review	AI comment 不能代替 Approve
学习	新人先过 git-essentials + test-intro 再用 Agent

CodeRoadMap 内容创作流

本站 content/课程/*/drafts/ 推荐：

1. outline.yaml 已定 slug、summary、order
2. 样例 @ 引用：同站 gha-intro.md 或相邻课
3. Cursor / Copilot 生成 markdown draft（50–70 行、中文结构）
4. 维护者通读：链接、代码、语气、与路线图节点一致
5. git commit：message 如 content(ai): draft ai-review from outline
6. PR review：事实与人审；AI 可查排版不一致

禁止：未核对就 bulk merge 12 章；编造 /tracks/... 链接。

功能代码仍靠 github-actions-essentials CI 门禁；讲义可加链接检查。

练习

• 起草半页「团队 AI 使用约定」五条
• 开一个只改 draft 的 PR，练习 AI usage 段落

小结

分支 + 自测 + 透明标注 + 人审；讲义与代码同一责任链。 下一课综合练习。