🛠️ VS Code Agent Skills 完全指南：从启用到自定义创建

18 个 Agent Skills，这是我目前 .claude/skills/ 目录下的 Skill 数量。从论文写作到博客生成，从 PDF 处理到 PPT 制作，这些 Skills 已经成为我日常工作流中不可或缺的一部分。

今天，我想分享如何在 VS Code 中启用和创建 Agent Skills——这可能是 2026 年最值得学习的 AI 工具技能之一。

🎯 什么是 Agent Skills？

Agent Skills 是模块化的能力扩展包，可以教会 AI 编程助手（如 GitHub Copilot、Claude）新的领域知识和专业技能。

想象一下：

你可以让 AI 学会你们公司的代码规范
你可以让 AI 掌握特定领域的写作风格
你可以让 AI 自动执行复杂的多步骤工作流

每个 Skill 本质上就是一个包含 SKILL.md 文件的文件夹：

skill-name/
├── SKILL.md           # 必需：Skill 定义和指令
├── references/        # 可选：参考文档
├── scripts/           # 可选：可执行脚本
└── assets/            # 可选：模板、图片等资源

SKILL.md 文件结构

---
name: skill-name
description: 详细描述这个 Skill 的用途和触发条件...
---

# Skill Name

## 核心功能

具体的指令和工作流...

关键点：description 字段非常重要！AI 会根据这个描述来判断何时应该使用这个 Skill。

🚀 VS Code 开启 Agent Skills

VS Code 1.108 (December 2025) 正式引入了 Agent Skills 支持。启用步骤：

Step 1: 更新 VS Code

确保你的 VS Code 版本 ≥ 1.108。

Step 2: 启用 Skills 设置

打开 Settings (⌘ + ,)，搜索 useAgentSkills：

{
  "chat.useAgentSkills": true
}

或者直接在设置界面勾选：

Chat: Use Agent Skills ✅

Step 3: 创建 Skills 目录

VS Code 支持两个位置存放 Skills：

位置	说明
`.github/skills/`	推荐位置（新标准）
`.claude/skills/`	兼容位置（Claude 原生支持）

我个人使用 .claude/skills/，因为这个目录可以在 Claude Code、VS Code、Claude Desktop 等多个环境中共享。

# 在项目根目录创建
mkdir -p .claude/skills

📦 获取官方 Skills 资源

Anthropic 维护了一个官方的 Skills 仓库，包含了大量开箱即用的高质量 Skills。

Clone 官方仓库

# Clone Anthropic 官方 Skills 仓库
git clone https://github.com/anthropics/skills.git anthropic-skills

# 查看可用的 Skills
ls anthropic-skills/

官方仓库包含的 Skills（截至 2026.01）：

Skill	用途
`skill-creator`	创建新 Skills 的向导
`frontend-design`	前端 UI 设计
`docx`	Word 文档处理
`pdf`	PDF 文件操作
`pptx`	PPT 演示文稿制作
`xlsx`	Excel 表格处理
`canvas-design`	可视化设计
`mcp-builder`	MCP Server 开发
...	更多

拷贝到项目目录

# 拷贝你需要的 Skills
cp -r anthropic-skills/skill-creator .claude/skills/
cp -r anthropic-skills/frontend-design .claude/skills/
cp -r anthropic-skills/docx .claude/skills/
cp -r anthropic-skills/pdf .claude/skills/

# 或者一次性拷贝全部
cp -r anthropic-skills/* .claude/skills/

验证是否生效

重启 VS Code 后，在 Chat 中输入相关问题，AI 应该会询问是否使用对应的 Skill：

💬 用户: 帮我创建一个 PowerPoint 演示文稿

🤖 AI: 我发现你有 pptx Skill 可用，是否需要我使用它来帮助创建演示文稿？

✨ 使用 Skill Creator 创建自定义 Skills

官方的 skill-creator 是创建新 Skill 的最佳起点。让我分享如何用它创建了 academic-paper-writer 和 blog-writer 两个 Skill。

创建 Academic Paper Writer Skill

这是一个帮助撰写和修改学术论文的 Skill。

触发方式：在 Chat 中直接说：

帮我创建一个用于学术论文写作的 Agent Skill

AI 会自动调用 skill-creator，然后我提供了以下需求：

功能定位：AI/ML 领域学术论文写作顾问
核心工作流：
- 论文从零撰写
- 全文修订润色
- 审稿意见回复
- 投稿策略建议
特殊需求：集成 Tavily 搜索获取最新文献

生成的 Skill 结构：

academic-paper-writer/
├── SKILL.md                          # 主文件 (~370行)
└── references/
    ├── ai-ml-domains.md              # AI/ML 领域分类
    ├── venues.md                      # 顶会/期刊信息
    └── writing-templates.md           # 写作模板

关键配置（SKILL.md frontmatter）：

---
name: academic-paper-writer
description: Expert AI/ML academic paper writing consultant for drafting, 
  polishing, revision, and publication guidance. Use when user asks to 
  (1) write academic papers from scratch, (2) revise or polish existing papers, 
  (3) prepare rebuttal letters, (4) get publication strategy advice. 
  Triggers on keywords like "write a paper", "paper revision", "reviewer response".
---

创建 Blog Writer Skill

这是我日常使用最频繁的 Skill，用于快速撰写技术博文。

需求输入：

创建一个博客写作 Skill，要求：
1. 第一人称叙述风格
2. 自动生成 Zola 静态网站的 frontmatter
3. 根据历史文章保持标签一致性

AI 分析了我博客目录下的 100+ 篇历史文章，提取了高频标签和分类模式，然后生成了定制化的 Skill。

生成的 Skill 结构：

blog-writer/
├── SKILL.md                          # 主文件 (~260行)
└── references/
    └── common-tags.md                 # Top 50 高频标签

核心功能：

四阶段工作流：理解需求 → 生成大纲 → 撰写正文 → 生成完整文件
Zola Frontmatter 自动生成：

+++
title = "文章标题"
date = 2026-01-18
template = "blog.html"
slug = "url-friendly-slug"
path = "url-friendly-slug"
archive = ["2026"]
[taxonomies]
category = ["AI工具"]
tags = ["标签1", "标签2"]
[extra]
author = "Polly"
summary = "100-150字摘要"
+++

开篇模式选择：场景开篇 / 问题开篇 / 数据开篇 / 观点开篇

💡 实践心得与技巧

经过创建和使用多个 Skills 后，我总结了几个关键经验：

1. Description 是灵魂

description 字段决定了 AI 何时会调用这个 Skill。写得越清晰、越具体，触发就越准确。

好的示例：

description: Use when user asks to (1) write academic papers from scratch, 
  (2) revise existing papers, (3) prepare rebuttal letters. 
  Triggers on keywords like "write a paper", "paper revision".

差的示例：

description: A skill for writing things.

2. 善用 References 目录

不要把所有内容都塞进 SKILL.md。把详细的参考资料放到 references/ 目录，AI 会按需加载：

references/
├── api-docs.md        # API 文档
├── code-style.md      # 代码规范
└── domain-terms.md    # 领域术语表

3. 保持 SKILL.md 精简

官方建议 SKILL.md 控制在 500 行以内。太长会影响 AI 的处理效率。

4. 测试触发条件

创建后，用不同的问法测试 Skill 是否能正确触发：

✅ "帮我写一篇论文" → 触发 academic-paper-writer
✅ "review 我的 paper" → 触发 academic-paper-writer
✅ "写一篇博客" → 触发 blog-writer
❌ "写代码" → 不应触发上述 Skills

🔧 常见问题

Q: Skill 没有被触发？

检查 chat.useAgentSkills 是否启用
重启 VS Code
检查 SKILL.md 的 frontmatter 格式是否正确（--- 分隔符）

Q: 多个 Skill 冲突怎么办？

让 description 更具体，避免重叠。或者合并为一个更通用的 Skill。

Q: 如何分享 Skill 给团队？

将 .claude/skills/ 或 .github/skills/ 目录加入 Git 仓库即可。团队成员 clone 后自动拥有相同的 Skills。

📚 相关资源

总结

Agent Skills 是 AI 辅助编程的一个重大进步。它让我们可以：

标准化工作流：把最佳实践固化为 Skill
知识沉淀：团队经验变成可复用的资产
效率提升：减少重复的上下文解释

从今天开始，试着把你最常用的工作流变成一个 Skill 吧。我的 academic-paper-writer 和 blog-writer 已经帮我节省了大量时间——包括这篇文章本身，就是用 blog-writer Skill 辅助完成的 😄

如果你有任何问题或创建了有趣的 Skill，欢迎在评论区分享！