VS Copilot最简AI技能入门模板

本套模板是 Copilot 可直接识别的最简化 Skill 方案，无需引入额外依赖，仅需放置于项目指定目录即可快速测试，核心功能为「自动输出当前项目的文件列表」，操作简单、易于验证。

关键前提：请确保已安装并启用 GitHub Copilot 扩展，VS Code 版本不低于 1.90，文件路径需严格符合 Copilot 的识别规范。接下来进入详细教程。

一、Skill 完整文件结构（直接复制到项目根目录）

在项目根目录新建文件夹，固定路径为：.github/skills/file-list-skill/，文件夹内需创建 2 个核心文件（无需额外内容）：

1. SKILL.md（核心配置文件，定义 Copilot 的执行逻辑）

---
name: file-list-skill # Skill 唯一标识（可自定义，需确保不重复）
description: 最简入门级 Skill，自动读取当前项目根目录的文件列表并输出
author: 入门测试
---
执行步骤（Copilot 将按顺序依次执行）
1. 调用 File System MCP 服务器，扫描当前项目根目录下的所有文件与文件夹
2. 自动过滤掉隐藏文件（如 .git、.vscode 等）
3. 以清晰易读的列表形式，输出所有可见文件及文件夹名称
4. 输出完成后，提示「Skill 执行成功，这是最简 AI Skill 测试」

2. manifest.json（可选配置，简化识别流程，确保 Copilot 能正确加载）

{
  "name": "file-list-skill",
  "version": "1.0.0",
  "description": "Copilot 最简入门 Skill，输出项目文件列表",
  "main": "SKILL.md",
  "requires": {
    "mcp": ["file-system"] // 声明所需 MCP 服务器（文件读取能力）
  }
}

二、测试步骤（三步完成，即刻生效）

1. 复制上述文件结构：在某个项目根目录下新建 .github/skills/file-list-skill/，分别创建 SKILL.md 和 manifest.json，并粘贴对应的内容；

2. 重启 VS Code（确保 Copilot 重新加载 Skill），打开 Copilot 聊天窗口（快捷键 Ctrl+Alt+I），并打开该项目；

3. 在 Copilot 聊天框中输入指令：运行 file-list-skill，点击发送，Copilot 会自动执行并输出当前项目的文件列表。
   

执行结果展示

三、关键说明（务必阅读，避免踩坑）

• 路径必须严格设置为 .github/skills/[skill名称]/，这是 Copilot 识别 Skill 的固定规则，不可更改；

• 无需手动配置 MCP：Copilot 会自动启用内置的 File System MCP，无需额外编写 mcp.json 文件；

• 测试验证：执行后即可看到项目根目录下的所有可见文件（如 package.json、next.config.js 等），表示 Skill 已成功生效；

• 支持自定义修改：将 SKILL.md 中的「执行步骤」替换为你需要的简单操作（例如「输出当前时间」「读取某个文件内容」），重启 VS Code 即可重新测试。

四、常见问题（快速排查指南）

1. Copilot 提示「找不到 Skill」：请检查路径是否正确，重启 VS Code，确认 Copilot 已登录账号；

2. 执行失败：请确保 VS Code 和 Copilot 扩展均为最新版本，无需禁用其他扩展（避免产生冲突）；

3. 无文件输出：检查项目根目录下是否存在可见文件，SKILL.md 中的执行步骤请保持最简配置。

核心概念总结：

MCP = 工具手：让 AI 能够操作文件、终端、Git、浏览器等资源
AI Skills = 操作手册：告诉 AI「如何正确使用这些工具完成任务」
组合运用：
MCP 提供能力 + Skills 提供流程 = 全自动编码助手

Prompt = 一次性小指令
Skill = 永久性专业技能
MCP = 让技能具备操作 系统 / 代码 / 终端 的能力