---
title: "12 · 真实团队工作流"
description: "给出 TDD、代码审查、PR 摘要、issue 到 PR、文档维护和迁移任务六种 Copilot 实战用法。"
verifiedAt: "2026-05-06"
---

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

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

## 1. 总工作流

```mermaid
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 验收。
- 不依赖本机登录态或私密环境。
- 风险中低，可以异步推进。

流程：

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

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

## 4. 工作流三：PR 摘要

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

结构：

```md
## What changed

## Why

## Risk

## Tests

## Rollback
```

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

## 5. 工作流四：代码审查

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

使用方式：

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

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

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

适合 Copilot：

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

不适合：

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

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

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

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

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

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

## 8. 团队 SOP 模板

```text
任务类型：
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](https://code.visualstudio.com/docs/copilot/guides/test-driven-development-guide)：VS Code 官方 TDD 指南。
- [Using GitHub Copilot code review](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review)：GitHub 官方 code review 使用说明。
- [Creating a pull request summary with GitHub Copilot](https://docs.github.com/en/copilot/how-tos/copilot-on-github/copilot-for-github-tasks/create-a-pr-summary)：GitHub 官方 PR summary 使用说明。
- [Achieving your company's engineering goals with GitHub Copilot](https://docs.github.com/en/copilot/get-started/achieve-company-goals)：GitHub 官方团队目标和 rollout 思路。

## 接下来去哪

<Cards>
  <Card title="上一篇" description="先确认团队安全、治理和计费边界。" href="/docs/github-copilot/understanding/11-security-admin-billing" />
  <Card title="回到目录" description="重新从 Copilot understanding 总览检查学习路径。" href="/docs/github-copilot/understanding" />
  <Card title="实战剧本官方页" description="查看 TDD、PR 摘要、代码审查和团队上线清单。" href="/docs/github-copilot/official/10-practical-playbooks" />
</Cards>
