12 · 真实团队工作流 · AI 编程教程中文版

工具教程最终要回到工作流。Copilot 真正的价值不是多生成几行代码，而是把团队每天反复做的工程动作变短：写测试、解释 diff、拆 issue、补文档、跑迁移、做 review——本章把前 11 篇的能力按"团队真实场景"重新组装。

本章目标：你会把前面 11 篇的入口、上下文、权限、Cloud Agent、CLI、MCP 和治理放进真实团队 SOP。

1. 总工作流

flowchart TD
  Issue["Issue / 需求"] --> Triage["Copilot Chat / Plan"]
  Triage --> Decide{"本地还是云端?"}
  Decide -->|本地| IDE["VS Code Agent Mode / CLI"]
  Decide -->|异步| Cloud["Cloud Agent branch"]
  IDE --> Diff["Diff / tests"]
  Cloud --> PR["Pull request"]
  Diff --> Summary["PR summary"]
  PR --> Summary
  Summary --> Review["Copilot review + human review"]
  Review --> Checks["CI / 手动验证"]
  Checks --> Merge{"合并?"}
  Merge -->|是| Ship["上线"]
  Merge -->|否| Iterate["迭代或回滚"]

这个流程里，Copilot 是每个环节的加速器，但每个环节都有人工验收点。

2. 工作流一：TDD 小步实现

用 Copilot 做 TDD（test-driven development，测试驱动开发），不是让它一次写完功能，而是限制在 Red（先写一个会失败的测试）、Green（让测试最快通过）、Refactor（保持测试通过的前提下整理代码）三段。

Red：

只写失败测试。
不改生产代码。
确认失败原因就是目标行为缺失。

Green：

只做最小实现。
不新增抽象。
跑相关测试。

Refactor：

只清理结构。
不改外部行为。
相关测试仍通过。

证据：Red 失败输出、Green 通过输出、Refactor 后通过输出，以及每一步 diff。

3. 工作流二：Issue 到 PR

适合 Cloud Agent：

issue 写清目标、范围和验收标准。
任务可以通过 branch、checks、PR review 验收。
不依赖本机登录态或私密环境。
风险中低，可以异步推进。

流程：

用 Chat 或 Plan 梳理 issue。
决定 assign issue 直接 PR，还是 prompt 到 branch 先迭代。
审 research 和 implementation plan。
审 branch diff。
创建 PR。
走普通 review 和 CI。

不要让 Cloud Agent 处理“还没想清”的需求。先让它 research 和 plan，不要直接改代码。

4. 工作流三：PR 摘要

PR 摘要不是 changelog。它要帮助 reviewer 快速进入上下文。

结构：

## What changed

## Why

## Risk

## Tests

## Rollback

Copilot 可以生成第一版，但作者必须补齐业务背景、风险、测试和回滚。测试只能写真实执行过的命令，不要让 Copilot 编造。

5. 工作流四：代码审查

Copilot code review 适合预筛风险，不替代人工 reviewer。

使用方式：

PR 目标和范围已经清楚。
请求 Copilot review。
逐条 triage 评论：采纳、手动修、关闭并说明原因。
修复后跑测试。
必要时请求 re-review。

官方文档提示，Copilot 不会因为推送新提交就自动重新 review；需要重新请求。自动 review 还要考虑 Actions minutes 和评论噪声。

6. 工作流五：文档和教程维护

适合 Copilot：

根据代码 diff 补 README。
同步 API 示例。
给配置项补说明。
检查站内链接和过期路径。
用 PR summary 草稿整理发布说明。

不适合：

编造官方事实。
复制没有核验的价格、计划和模型信息。
忽略截图、断点和实际构建。

教程类内容要有来源、核验日期、链接和可执行验证。

7. 工作流六：迁移和批量改造

迁移任务可以用 Copilot，但必须分阶段：

Ask / Plan：列影响文件和风险。
Agent / CLI：只做第一小批。
Tests：跑局部测试。
Review：人工看 diff。
Expand：再扩大到下一批。

适合用 prompt file 或 skill 固化迁移步骤；高风险命令用 hook 或权限策略拦住。

8. 团队 SOP 模板

任务类型：
TDD / issue-to-PR / review / docs / migration

入口：
GitHub.com / VS Code Agent / CLI / Cloud Agent

上下文：
issue、文件、PR、测试输出、MCP 工具

权限：
允许改哪些路径
允许跑哪些命令
禁止哪些工具和系统

验收：
diff、tests、checks、review、rollback

一个 SOP 要能让新人按同样流程复现，而不是只靠某个老员工的经验。

本章自检

你应该能回答：

这个任务属于哪类工作流？
入口为什么选 GitHub.com、IDE、CLI 或 Cloud Agent？
上下文和权限边界是什么？
验收证据在哪里？
失败时怎么回滚或人工接管？

通过标准：Copilot 被放进工程流程，而不是游离在流程外单独“生成代码”。

官方来源

Set up a test-driven development flow in VS Code：VS Code 官方 TDD 指南。
Using GitHub Copilot code review：GitHub 官方 code review 使用说明。
Creating a pull request summary with GitHub Copilot：GitHub 官方 PR summary 使用说明。
Achieving your company's engineering goals with GitHub Copilot：GitHub 官方团队目标和 rollout 思路。

12 · 真实团队工作流