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

2026-05-31阅读 0热度 0

Copilot

此模板是 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 步完成，立即生效）

将上述文件结构部署到项目：在根目录创建 .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 = 让 Skill 得以操控系统 / 代码 / 终端