如何通过自定义 .github/copilot-instructions.md 统一团队的代码风格？

很多团队在用 Copilot 时最头疼的就是：每个人生成的代码风格都不一样，有人爱写箭头函数，有人坚持用 function 关键字，导致 PR 评审时得花大量时间在纠结缩进和命名这种琐事上。其实 Copilot 现在支持在项目根目录创建 .github/copilot-instructions.md，这相当于给 AI 注入了一套“团队行为准则”，比在全局设置里写提示词要高效得多。

我最近给团队配置这套方案，发现最关键的是不要写模糊的形容词（比如“代码要简洁”），而要写具体的判定标准。

我的 .github/copilot-instructions.md 核心配置逻辑如下：

# TypeScript 编码规范

- 变量命名：所有私有成员必须以下划线 `_` 开头。
- 异步处理：禁止使用 `.then()`，必须统一使用 `async/await` 配合 `try-catch` 块。
- 类型定义：优先使用 `interface` 而非 `type`，除非是在定义联合类型。
- 状态管理：所有 Zustand store 的 action 必须定义在单独的 `actions` 对象中，禁止散落在根层级。

# 业务上下文
- 所有的 API 请求必须经过 `src/api/client.ts` 的封装，严禁直接调用 `axios`。
- 错误处理必须调用 `Logger.error()` 记录 traceId。

配置完这个文件后，你会发现 Copilot 在补全代码或通过 Chat 窗口生成函数时，会自动遵循这些约定。比如当你写一个异步请求时，它不再会随缘给你写 .then()，而是直接生成 try-catch 结构。

这里有个踩坑点： 如果你的项目里已经有了 .eslintrc 或 .prettierrc，千万不要在 instructions 文件里重复写一遍缩进、分号这些基础配置。AI 对 Lint 文件的感知力很强，重复定义反而会让它在生成时产生冲突，导致代码一会儿加分号一会儿不加。

提升效率的小技巧：
如果你在重构老代码，可以直接在 Chat 中输入 @workspace 按照 .github/copilot-instructions.md 的规范重构当前文件。这样它会扫描整个指令集，一次性把不符合团队风格的地方全部修正，比你手动一行行改要快得多。

目前的实测结果是，新入职的同事通过这套配置，代码风格的对齐速度快了大概 50%，因为 AI 在他写代码的瞬间就完成了第一轮的“风格审查”。