使用说明

GitHub Copilot SuperPowers

Opinionated，repo本地配置 GitHub Copilot（聊天+代理模式）：指令层次结构、可重用提示文件、自定义代理配置文件和MCP服务器配置。

快速入门 • 里面是什么 • 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中的块）不会在所有地方都呈现，并且会故意限制它们的嵌套位置。如果你将部分复制/粘贴到以下位置 <details> 或者嵌套列表，您可能需要将其重写为纯块引号。