VS + Copilot 最简入门 AI Skill 模板

此模板为 Copilot 可直接识别的最简 Skill,无需额外依赖,放入项目指定目录即可测试,核心功能是「自动输出当前项目的文件列表」(简单易验证,无复杂操作)。

核心要求:确保已安装并启用 GitHub Copilot 扩展,VS Code 版本 ≥ 1.90,文件路径必须符合 Copilot 识别规则。

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

项目根目录新建文件夹,路径固定为:.github/skills/file-list-skill/,文件夹内创建 2 个核心文件(无需多余内容):

1. SKILL.md(核心配置文件,告诉 Copilot 做什么、怎么做)

python 复制代码
---
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 识别)

javascript 复制代码
{
  "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 = 让技能能操作系统 / 代码 / 终端

相关推荐
水如烟7 小时前
孤能子视角:通用智能 vs 分工协同智能群系统–––集中结晶 vs 分布式结晶
人工智能
罗西的思考7 小时前
【轻量化复现大模型 / KIMI K3】训练模块梳理 & Muon P2P 优化器
人工智能·深度学习·机器学习
lilihuigz7 小时前
权限配置:WordPress 7.2 Abilities API 权限、输入验证与 JSON 输出指南
人工智能
杨凯凡7 小时前
IT日报|2026-11-20:欧盟 AI 网络攻击、Valkey 9.2、GitHub 企业迁移
人工智能·github
鲁邦通物联网8 小时前
机器人梯控到站状态机设计:楼层匹配、事件时序与任务判断
人工智能·机器人·机器人梯控·agv梯控·非侵入式采集·机器人乘梯·机器人自主乘梯
静水深码8 小时前
文生图提示词的工程师写法:把玄学话术拆成结构化模板
人工智能·后端·代码规范
Seiran8 小时前
Claude Fable 5.1写技术方案,ZEEKEAI提效实录
人工智能
JonaHu8 小时前
GPT Image 2.6 多语言海报改版:保留商品细节,分离文案与图像验收
图像处理·人工智能·aigc
4cos908 小时前
pi学习笔记-BranchSummary
人工智能
程序员张富华9 小时前
一次发布拦住12个破坏性变更:我们给Agent工作流加了Schema门禁
人工智能·agent