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 识别 Skill）

{
  "name": "file-list-skill",
  "version": "1.0.0",
  "description": "Copilot 最简入门 Skill，输出项目文件列表",
  "main": "SKILL.md",
  "requires": {
    "mcp": ["file-system"]
  }
}

二、测试步骤（三步完成，直接生效）

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 将自动执行并输出当前项目的文件列表。
   

执行结果：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 = 让技能能够操作系统/代码/终端