本套模板是 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 服务器（文件读取能力）
}
}
二、测试步骤（三步完成，即刻生效）
-
复制上述文件结构：在某个项目根目录下新建
.github/skills/file-list-skill/，分别创建 SKILL.md 和 manifest.json，并粘贴对应的内容； -
重启 VS Code（确保 Copilot 重新加载 Skill），打开 Copilot 聊天窗口（快捷键 Ctrl+Alt+I），并打开该项目；
-
在 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 = 让技能具备操作 系统 / 代码 / 终端 的能力
