VS Copilot AI Skill模板推荐：最简入门

此模板是 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 服务器（文件读取能力）
  }
}

二、测试步骤（3 步完成，立即生效）

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 = 让 Skill 得以操控系统 / 代码 / 终端

来源：互联网