GitHub Copilot 视频动态摘要

这是理解和使用 Copilot 最重要、最有效的心智模型。

• 把它当作一个有优势也有弱点的协作伙伴，而不是一个只会执行命令的工具。
• 你需要与它“结对编程”，共同解决问题。

Copilot 的表现好坏，直接取决于你提供的上下文质量。上下文远不止是你的“提示词 (Prompt)”。

• 清晰可读的代码： 避免使用晦涩的缩写和单字母变量，代码本身就是最重要的上下文。
• 有意义的注释： 在关键位置添加注释，能极大地帮助 Copilot 理解你的意图。
• 良好的项目结构： 合理的文件和目录组织，能帮助 Copilot 快速定位相关信息。
• 明确的意图： 不要“被动攻击式”地提问，如果你知道怎么做，或者希望它怎么做，就明确告诉它。

根据不同场景，Copilot 提供从辅助到主导的不同工作模式。

• 代码补全 (Completion)： 最经典的功能，在你编码时实时提供代码建议。
• 聊天模式 (Chat)： 用于对话式交互，如解释代码 (Ask)、修改多个文件 (Edit)。
• 本地 Agent 模式： Copilot 能在本地主导任务，探索项目、运行测试、甚至自我修复。
• [新] 编码 Agent (Coding Agent)： 终极模式！你可以将一个 GitHub Issue 直接指派给 Copilot，它会自动完成编码、测试，并提交一个 Pull Request，实现异步协作。

通过在项目中创建特定的 Markdown 文件，可以为 Copilot 提供持久化、可复用的高质量上下文。

• 全局指令： /.github/copilot-instructions.md。此文件中的内容（如项目概览、编码规范、技术栈）会应用到该仓库所有的聊天和 Agent 任务中。
• 特定任务指令： /docs/copilot/instructions/*.md。可以为特定任务（如“创建 Flask 路由”）编写模板，并通过 apply to: 规则使其在编辑特定文件时自动生效。

编码 Agent 在设计上将安全性放在了首位。

• 运行环境： 它在一次性的、隔离的 GitHub Actions 环境中运行，任务结束后环境即销毁。
• 权限限制： 对仓库只有只读权限，唯一的例外是它可以写入自己创建的那个特定分支 (copilot-fix-...)。
• 网络隔离： 默认情况下，Agent 无法访问任何外部网络资源。你必须在项目设置中显式地为特定域名打开防火墙。
• 人工审核： Agent 创建的 Pull Request 不会自动运行CI/CD工作流。必须由人类开发者审查代码后，手动点击按钮触发。

• 内部库： Copilot 是一个强大的模式匹配器。它不需要看到内部库的源码，只需要在你的项目中看到足够多如何使用这个库的示例，它就能学会如何正确地调用它。
• 外部数据源 (如数据库)：
  • 简单方式： 将数据库的 DDL (表结构定义) 放入 copilot-instructions.md 文件中。
  • 高级方式： 通过 MCP (Model Context Protocol)。你可以构建一个 MCP 服务，作为 Copilot 和外部服务（如数据库、Jira API）之间的桥梁，从而扩展其能力。

• 支持微调 (Fine-tuning) 吗？ 答：目前不支持。因为仓库中同时存在好代码和坏代码，微调难度高。当前更推荐通过指令文件和 MCP 提供高质量上下文（一种 RAG 模式）。
• 支持 Jira/ADO Issues 吗？ 答：编码 Agent 目前仅支持 GitHub Issues。可以考虑写脚本将 Jira Issue 同步到 GitHub。