GitHub Copilot SuperPowers
Opinionated,repo本地配置 GitHub Copilot(聊天+代理模式):指令层次结构、可重用提示文件、自定义代理配置文件和MCP服务器配置。
\[!注意\] 这个存储库有意地很小 高度固执己见。它被设计成可以复制到其他仓库并进行改编。
为什么存在
当你明确设置GitHub Copilot的“默认值”时,它会变得更加有用:遵循哪些质量条,何时停止和调查,以及如何保持编辑范围。 这个仓库将这些默认值打包成易于版本、审查和重用的形式。
里面是什么
- 指令系统 在...之下
.github/instructions/(规则、工作流程、质量门、执行协议) - 可重用提示 在...之下
.github/prompts/(例如:生成README,生成AGENTS.md,回购故事时间,创建发行说明) - 自定义代理 在...之下
.github/agents/(例如:批判性思维、导师、门卫) - 特工“技能”剧本 在...之下
.github/skills/(调查模式、根本原因追踪、验证门、不确定性验证、最小化开发、任务方向批准) - VS代码工作区设置 在...之下
.vscode/settings.json(启用Copilot代理功能、高级推理、MCP集成) - MCP配置 在...之下
.vscode/mcp.json(顺序思维,情境7,记忆,Serena)
快速入门
将此仓库用作模板
- 将这些文件夹复制到目标存储库中:
- .github/ - .vscode/
- 审查和定制说明文件:
- 从开始 .github/copilot-instructions.md - 然后调整规则 .github/instructions/ 以匹配你的团队对“护栏”的容忍度。
\[!重要\] 指令集在 .github/instructions/ 旨在减少片状和“试剂漂移”,但也会让人感觉很严格。 如果您不希望委派繁重的工作流,或者您没有使用子代理,请放松或删除这些约束。在VS代码中使用它
- 在VS Code中打开存储库(或复制这些文件的存储库)。
- 确保GitHub Copilot已启用。
- 保持
.vscode/settings.json签入后,工作区默认值将随仓库一起移动。
代理技能
代理技能是可选的剧本,可以按需加载以处理特定场景。当你需要专门处理复杂任务时,要掌握一项技能。
位于 .github/skills/,此repo包括6个即用型技能:
| 技能 | 目的 | 何时使用 |
|---|---|---|
| 调查模式 | 在连续2次以上失败后暂停实施,并在恢复之前切换到根本原因分析 | 重复测试失败或验证错误 |
| 根本原因追踪 | 通过调用堆栈向后跟踪错误,找到原始触发器,而不仅仅是症状 | 对复杂问题的深度调试 |
| 任务方向批准 | 解释故障的根本原因,提出2-3个具有权衡的解决方案选项,并等待用户明确选择 | 在切换技术栈或架构之前 |
| 不确定性验证 | 通过官方文档验证确切的命令、配置密钥、API详细信息和版本特定的行为-无假设 | 当提供版本相关或时间敏感的指导时 |
| 完工前的验证 | 在做出任何完成声明之前,运行验证命令并确认输出 | 在将任务标记为已完成或已修复之前 |
| 极简主义外科发展 | 优先考虑最小的差异,首选标准库,避免主动重构 | 代码更改和重构工作 |
自定义代理
定制代理为集中协作定义了专门的“模式”。当您希望为特定任务定制行为时,请选择代理配置文件。
位于 .github/agents/,此仓库包括4个自定义代理配置文件:
| 代理人 | 角色 | 最适合 |
|---|---|---|
| 批判性思维 | 质疑假设并鼓励探索替代方法和边缘案例 | 架构审查、设计决策、风险分析 |
| 导师 | 通过批判性提问提供苏格拉底式指导,但不提供直接解决方案 | 学习、技能发展、理解复杂系统 |
| 清洁工 | 专注于清理、简化和技术债务修复 | 代码清理、重构、删除死代码、性能优化 |
| 技术债务补救计划 | 生成包含指标和可操作步骤的全面技术债务修复计划 | 技术债务分析、代码质量评估、规划重构工作 |
MCP服务器
此存储库包括一个即用型MCP配置,位于 .vscode/mcp.json.
模型上下文协议(MCP)服务器通过专用工具和信息源扩展了Copilot的功能。
已配置的服务器:
| 服务器 | 用途 | 启动方法 |
|---|---|---|
| 顺序思维 | 结构化多步推理,内置修订支持,可解决复杂问题 | npx |
| 背景7 | 最新的库和框架文档查找——始终检索当前版本文档 | npx |
| 记忆 | 用于存储发现的模式、架构见解和重复解决方案的轻量级知识图 | npx |
| 塞雷娜 | 项目感知代码智能:符号操作、文件搜索、重构和代码库分析 | uvx python uv 工具) |
先决条件和故障排除
- Node.js:必需
npx-基于服务器(顺序思维、上下文7、内存) - python
uv工具:Serena MCP服务器需要通过uvx - 没有MCP服务器启动? 验证是否安装了Node.js(
npm --version)以及uv可用(uv --version)
VS代码设置
位于 .vscode/settings.json,工作区包括优化的Copilot代理配置。
代理和技能激活
| 设置 | 目的 |
|---|---|
chat.agent.maxRequests | 限制每个会话的代理请求(设置为125) |
chat.useAgentSkills | 启用加载技能 .github/skills/ 用于专门的任务处理 |
chat.useAgentsMdFile | 从加载自定义代理配置文件 .github/agents/*.agent.md |
chat.useNestedAgentsMdFiles | 支持多级代理配置文件组织 |
chat.customAgentInSubagent.enabled | 允许子代理使用自定义代理配置文件进行复杂的委派 |
高级推理和代码质量
| 设置 | 目的 |
|---|---|
github.copilot.chat.responsesApiReasoningEffort | 设置为 "high" 进行更深入的问题分析,减少错误 |
github.copilot.chat.responsesApiReasoningSummary | 设置为 "detailed" 用于深入思考和解释 |
inlineChat.enableV2 | 在代码编辑期间启用内联聊天建议 |
github.copilot.nextEditSuggestions.enabled | 根据聊天记录提供上下文编辑建议 |
上下文和搜索
| 设置 | 目的 |
|---|---|
github.copilot.chat.newWorkspace.useContext7 | 自动启用Context7 MCP,以便在新工作区中查找文档 |
github.copilot.chat.scopeSelection | 将上下文限制为焦点提示的当前选择 |
github.copilot.chat.codesearch.enabled | 在聊天上下文中启用语义代码搜索 |
github.copilot.chat.alternateGptPrompt.enabled | 提供替代的提示重写建议 |
MCP和CLI集成
| 设置 | 目的 |
|---|---|
github.copilot.chat.useResponsesApi | 实现推理和扩展分析功能 |
github.copilot.chat.cli.customAgents.enabled | 允许从CLI使用自定义代理 |
github.copilot.chat.cli.mcp.enabled | 在CLI模式下为代理工作流启用MCP服务器 |
github.copilot.chat.githubMcpServer.enabled | 激活GitHub MCP进行仓库操作(问题、PR、代码搜索) |
github.copilot.chat.githubMcpServer.readonly | 将GitHub MCP限制为只读模式(设置为 true 为了安全) |
分析
| 设置 | 目的 |
|---|---|
editor.aiStats.enabled | 跟踪人工智能辅助代码编写指标以获取见解 |
回购布局
.
├─ .github/
│ ├─ copilot-instructions.md
│ ├─ agents/
│ ├─ instructions/
│ ├─ prompts/
│ └─ skills/
└─ .vscode/
├─ mcp.json
└─ settings.json备注
\[!小心\] GitHub风格的警告(如本README中的块)不会在所有地方都呈现,并且会故意限制它们的嵌套位置。如果你将部分复制/粘贴到以下位置 `` 或者嵌套列表,您可能需要将其重写为纯块引号。
