GitHub Copilot 入门：教 Copilot 认识你的代码库

## GitHub Copilot 入门：教 Copilot 认识你的代码库

摘要： Learn how to add custom instructions and skills to your repository, use custom agents, and connect MCP servers like Playwright. The post GitHub Copilot app for Beginners: How to teach Copilot about your codebase directly helps developers make AI coding assistants learn project-specific rules, conventions, and repeatable workflows—perfect for teams using GitHub Copilot alongside Cursor, Claude Code, or OpenAI models.

开篇：GitHub Copilot 为什么需要“认识你的代码库”

GitHub Copilot 已经进化到 2026 年，能直接在 VS Code、Cursor 等 IDE 中运行，但它最聪明的时候是知道你项目里的“规矩”。不是每次都重复提示“请按我们公司命名规范写”，而是 Copilot 自动从仓库里拿到这些上下文。

Cursor 用户特别适用：你用 Cursor 写代码，切换到 Copilot 聊天窗口或应用时，它就能立刻理解你的架构、测试规则和脚本。以下内容来自 GitHub 官方 2026-10-12 发布的最新入门指南，教你用四种方式让 Copilot 真正“懂”你的项目。

四种定制方式：一步步让 Copilot 学会你的代码库

#### 1. 自定义指令（Custom Instructions）：把项目规则塞进仓库

最简单、最基础的做法。在 .github 文件夹下新建 copilot-instructions.md，写下全局规则，比如：

• 架构偏好（我们用组件化设计）
• 命名约定（函数名必须用 kebab-case）
• 测试要求（必须有单元测试 + 快照测试）

还可以创建路径特定指令文件夹 .github/instructions，通过 applyTo 字段针对特定文件类型生效。

示例结构：

# Repository Instructions

Apply to: all files

Architecture: Use React + TypeScript

Naming: kebab-case for functions

Testing: 100% coverage required for new features

这样，Copilot 在处理你的代码时会自动参考这些规则，避免风格不一致。

#### 2. 代理技能（Agent Skills）：打包可重复的任务流程

当你需要重复执行“跑测试 + lint + 修复”的步骤时，用技能就方便多了。

在 .github/skills/ 下建子文件夹，比如 quality-checks，里面放 SKILL.md：

• 描述：什么时候触发（代码变动后）
• 脚本：npm test、npm run lint
• 检查项：覆盖率、eslint 规则
• 故障排除：常见报错解决办法

更新 Copilot 界面后，它会自动加载技能，按你定义的流程操作，省去每次手动指定命令。

#### 3. 自定义代理（Custom Agents）：处理跨文件的大任务

Accessibility Review、代码重构这类需要多文件协调的工作，适合创建专属代理。

在 .github/agents/ 下创建代理配置文件，定义：

• 代理角色和目的
• 使用的工具列表
• 项目上下文

比如一个“测试自动化代理”：它会遍历所有 test 文件、运行 Playwright 测试、生成报告。

#### 4. 连接 MCP 服务器：让 Copilot 访问外部工具（如 Playwright）

MCP（Model Context Protocol）服务器把外部服务接入 Copilot。

推荐 Playwright MCP：配置后你可以直接问 “Use the Playwright MCP server to test the functionality manually”，Copilot 就会打开浏览器交互测试。

想快速体验？去 GitHub 官方页面查看完整配置步骤。

决策对比表：四种方式怎么选

方式	适用场景	文件位置	推荐场景示例	搭配 Cursor / Claude Code 的效果
自定义指令	全局规范、命名规则	.github/copilot-instructions.md	团队代码风格统一	提升一致性，减少重复解释
代理技能	重复多步流程（如测试）	.github/skills/	发布前质量检查	让技能自动触发，节省时间
自定义代理	复杂跨文件任务	.github/agents/	无障碍审查或重构	专属视角，处理规模更大任务
MCP 服务器	外部工具集成（如浏览器测试）	无需文件，需在 Copilot app 配置	Playwright 自动测试	扩展功能边界，验证 UI 行为

表格说明：列数控制在 4 以内，移动端可横向滚动查看。实际效果以 Copilot 最新版本为准（2026 年 10 月数据）。

风险与边界

这些自定义方式全部基于官方文档和 GitHub Copilot 应用设置，未涉及任何绕过、注入或非官方修改行为。仅供合法企业内部使用，请确认你的组织已开通 GitHub Copilot Enterprise 或 Business 订阅。数据以 2026-10-12 官方发布内容为准，升级后 Copilot 界面可能略有变化，具体以最新版本为准。

免责声明：本文仅供参考，不构成任何法律意见或专业咨询。实际效果因项目规模、Copilot 版本而异，请自行测试。