<!-- title: 别只用Copilot补全：8个隐藏玩法 -->
<!-- domain: tips-tricks -->

# 别只用Copilot补全：8个隐藏玩法

**导语**：提起 GitHub Copilot，90% 的人脑子里只有一个画面——代码补全。但你可能不知道：这个你早就在付费（或白嫖免费版）的工具，如今已经是一个完整的 Agent 平台——云端自主干活、按路径读你的规矩、PR 自动审查、甚至能记住你仓库的脾性。而这些能力，海外团队已经在批量用于生产，国内却几乎没有像样的中文教程。本文把 GitHub 官方文档里藏着的 8 个高价值玩法一次性挖出来，全部可立刻上手，大部分不额外花钱。

---

## 先说清楚：Copilot 现在到底是个什么东西

根据 GitHub 官方文档（docs.github.com/en/copilot/about-github-copilot/github-copilot-features），今天的 Copilot 已经远不止补全，它包括：代码补全、Chat、**Copilot 云端 Agent**（自主领 issue 干活并开 PR）、**Agent mode**（本地多文件自主编辑）、代码审查、PR 摘要、自定义指令体系、Prompt 文件、Copilot Spaces、知识库，以及 Windows Terminal 里的 CLI 形态。

换句话说：你拿它当补全用，等于买了台瑞士军刀只用来开啤酒瓶。

---

## 技巧一：一个 copilot-instructions.md，让它永久“懂”你的仓库

**操作步骤**：在仓库根目录创建 `.github/copilot-instructions.md`，用自然语言写下项目约定——构建命令、测试方式、目录结构、代码风格、禁区。

**预期效果**：之后每次 Chat、Agent mode、代码审查，这些规则自动注入上下文，不用每次重复“我们用 pnpm 不用 npm"“必须先跑 lint"。

**官方隐藏彩蛋**：懒得写？GitHub 官方文档里公布了一段完整的“自我引导提示词”——去 `github.com/copilot/agents`，选中仓库，粘贴官方那段 onboarding prompt，云端 Agent 会自己通读你的代码库，探索构建流程、踩一遍坑（包括记录哪些命令会超时、哪些环境变量看似可选实则必需），然后开一个草稿 PR 把生成好的指令文件提交给你审阅。**让 AI 给 AI 写使用说明书**，这个玩法大多数人根本想不到。

**适用场景**：接手老项目、团队新人多、想让 Agent 干活少翻车。

---

## 技巧二：AGENTS.md——写一份文件，五大 AI 工具通吃

**认知差重点**：`AGENTS.md`（github.com/agentsmd/agents.md，目前约 **24k Star**，MIT 协议）被称为“给 Agent 看的 README"，已经是行业开放格式。GitHub 官方文档明确支持它，并且规则是：**Agent 工作时采用目录树上离它最近的那个 AGENTS.md**——意味着前端子目录和后端子目录可以有各自不同的规矩。

更妙的是官方文档原话：仓库根目录放一个 `CLAUDE.md` 或 `GEMINI.md` 也可以被识别。也就是说，一份规范文件，Copilot、Claude Code、Cursor 等工具都认。

**为什么值得关注**：你团队里可能同时有人用 Claude Code、有人用 Cursor、有人用 Copilot。以前要维护三份说明文件，现在一份 AGENTS.md 分层放置，全平台生效。这不是效率技巧，是团队协作基建。

---

## 技巧三：按路径生效的“分区宪法”

`copilot-instructions.md` 是全局的，但 Copilot 还支持**路径级指令**：

**操作步骤**：创建 `.github/instructions/` 目录，写 `NAME.instructions.md` 文件，文件开头用 frontmatter 指定作用范围：

```markdown
---
applyTo: "app/models/**/*.rb"
---
这个目录下的模型改动必须附带迁移脚本，
禁止在模型层写业务逻辑。
```

支持标准 glob 语法，逗号分隔多模式（如 `"**/*.ts,**/*.tsx"`）。还有个极少人知道的 `excludeAgent` 字段：填 `"code-review"` 或 `"cloud-agent"`，可以让某条规则只对云端 Agent 生效、代码审查忽略它（或反之）。

**预期效果**：给 AI 立“分区规矩”——前端目录允许 Tailwind，遗留代码目录禁止自动重构，测试目录必须用 Vitest 写。精度完全不是一个量级。

**注意**：官方文档说明，路径级指令目前在 github.com 上仅对云端 Agent 和代码审查生效。

---

## 技巧四：Prompt 文件——把常用提示词做成团队“斜杠命令”

**操作步骤**：
1. VS Code 设置里加 `"chat.promptFiles": true`；
2. 在 `.github/prompts/` 下建 `*.prompt.md` 文件；
3. 文件内可用 `#file:../../web/index.ts` 语法引用具体代码文件做上下文；
4. Chat 里通过 Attach context → Prompt 调用（JetBrains 里甚至直接输 `/命令名`）。

**为什么是信息差**：你每次手敲的“帮我按三层架构生成一个 CRUD 模块”“按我们的格式写技术方案”，都可以固化成 `.prompt.md` 提交进仓库——**提示词跟着 Git 走，全团队复用、版本化、可 review**。社区已有现成库：官方文档指向 "Awesome GitHub Copilot Customizations" 仓库，各种语言和场景的 prompt 文件直接抄。

---

## 技巧五：把 issue 丢给 Copilot，让它当你的“云端实习生”

这是本文最大的信息差。**Copilot 云端 Agent**（原名 coding agent，现已升级为可研究、可规划、可迭代的完整形态）的用法：

**操作步骤**：
1. 打开任意 GitHub issue，assignee 里选 **Copilot**；
2. 它在 GitHub Actions 驱动的独立沙箱环境里自主研究代码、规划、改代码、跑测试和 lint；
3. 完成后开一个草稿 PR 并 @ 你审阅；
4. 不满意？在 PR 里评论 `@copilot 把错误处理改成 xxx`，它继续改。

还能反向操作：在已有 PR 里 `@copilot` 让它按审查意见修改；在 Chat 里让它直接开 PR。

**价格差重点**（官方文档原文）：云端 Agent 消耗的是 **GitHub Actions 分钟数 + Copilot premium requests**，**在月度配额内不产生额外费用**。也就是说，一份 Copilot Pro 订阅（个人版每月 10 美元档，以官网定价页为准），就自带一个 7×24 待命的初级工程师，专门消化 backlog 里那些“重要但不紧急”的活：补测试、更新文档、解决合并冲突、偿还技术债。

---

## 技巧六：Copilot Memory——让 Agent 记住你仓库的“脾气”

2026 年的公测新功能：Pro / Pro+ 用户可开启 **Copilot Memory**，Agent 会自动沉淀它自己摸索出来的仓库知识（哪里是核心逻辑、构建有什么坑），下次云端 Agent 干活直接调用。

**为什么重要**：传统 Agent 每次开工都是“失忆状态”，同一个仓库重复探索、重复踩坑。Memory 等于给实习生发了本工作笔记，越用越熟练。这是官方文档明确标注 public preview 的功能，国内社区几乎没有讨论。

---

## 技巧七：Custom Agents + Hooks——批量生产“专科医生”

云端 Agent 支持深度定制，官方文档列出四件套：

- **Custom Agents**：创建专职 Agent——只管 React 前端的、只写技术文档的、只补单元测试的，各自挂不同的指令和工具；
- **MCP 服务器接入**：给 Agent 外挂数据源和工具；
- **Hooks**：在 Agent 执行的关键节点自动执行 shell 脚本——跑安全扫描、加日志、做校验，相当于给流水线加质检员；
- **Skills**：用指令+脚本+资源包增强特定任务能力。

**适用场景**：团队把“文档同步”“测试覆盖率”“安全扫描”这些没人爱干的活，各配一个专职 Agent，issue 打上标签自动流转。

---

## 技巧八：代码审查 + Next Edit Suggestions——从“写代码”延伸到“守代码”

两个容易被忽略的点：

1. **Copilot 代码审查吃你的自定义指令**：仓库设置 → Copilot → Code review，可开关"Use custom instructions when reviewing pull requests"（默认开启）。你在技巧一、三里写的规矩，AI 审 PR 时同样遵守——**规矩写一次，从生成到审查全链路生效**。还有个细节：审 PR 时用的是**目标分支**（base branch）上的指令文件。
2. **Next Edit Suggestions**（VS Code 独占）：不只补全光标处，还**预测你下一处要改哪里**并给出建议——重构时的连环修改效率翻倍。

---

## 一张图看懂指令体系如何全链路生效

```mermaid
flowchart TD
    A[你的 Git 仓库] --> B[".github/copilot-instructions.md<br/>全局规则"]
    A --> C[".github/instructions/*.instructions.md<br/>applyTo 按路径分区生效"]
    A --> D["AGENTS.md<br/>子目录就近优先"]
    B --> E[IDE Chat / Agent mode]
    C --> E
    B --> F[云端 Agent 开工前读取]
    D --> F
    C --> G[Code Review 按规矩审 PR]
    D --> G
    F --> H[Actions 沙箱环境<br/>自主改码 + 跑测试]
    H --> I[草稿 PR 并 @ 你]
    I -->|评论区 @copilot 继续改| F
    I --> J[合并 → Memory 沉淀仓库经验]
```

---

## 信息差总结

| 维度 | 你知道的 | 别人已经在用的 |
|------|---------|--------------|
| 定位 | 补全工具 | Agent 平台（云端领 issue、开 PR） |
| 规矩传达 | 每次手动粘贴提示词 | 指令文件入库，全链路自动生效 |
| 团队协作 | 各用各的 AI，各写各的约定 | 一份 AGENTS.md，多工具通吃（24k Star 开放标准） |
| 提示词 | 散落在聊天记录里 | `.prompt.md` 进仓库，版本化全团队复用 |
| 成本 | 以为 AI 干活要另付费 | Actions 分钟数+月度配额内零额外成本 |
| 记忆 | 每次“失忆”重来 | Copilot Memory 越用越懂你仓库 |

## 行动指南

1. **今天（10 分钟）**：在你的主力仓库建 `.github/copilot-instructions.md`，写清构建/测试/lint 三件事；
2. **本周（1 小时）**：把根目录的 README 精华提炼成 AGENTS.md，试跑 Copilot + Claude Code 双端验证；
3. **本周（30 分钟）**：挑一个积压的“补测试”issue，assignee 选 Copilot，看它交回的草稿 PR；
4. **本月**：沉淀 3 个高频场景的 `.prompt.md`，在团队内推广；如有 Pro+ 订阅，打开 Copilot Memory。

**一句话总结**：AI 编程工具的竞争已经从“谁补全更聪明”进入“谁的 Agent 更听话”阶段——而“听话”的关键，是你有没有把团队知识写成 AI 能读的规矩。Copilot 把整套体系免费藏在了你的订阅里，别再只用它补全了。

## 参考来源

1. GitHub Copilot 官方功能总览：https://docs.github.com/en/copilot/about-github-copilot/github-copilot-features
2. 自定义指令官方文档（含官方 onboarding 提示词全文）：https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
3. Copilot 云端 Agent 概念文档：https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent
4. AGENTS.md 开放标准仓库（24k Star）：https://github.com/agentsmd/agents.md
5. AGENTS.md 官网：https://agents.md/

---
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
