零基础上手 AI Agent Skill：从自定义首个技能到 VS Code 实战落地

PeterMap
1 阅读8分钟

当下 AI Agent 智能化落地的核心突破口，不再是大模型本身的对话能力，而是可标准化、可复用、可固化的 Skill 技能体系。传统对话式 AI 输出随机性强、无固定规范、无法沉淀业务经验，而 Skill 能够将人工流程、编码规范、工具操作逻辑固化为 AI 可识别、可自动执行的标准规则。

简单来说，Skill 让大模型摆脱“凭感觉输出”的弊端，实现按规则干活、按流程执行、按标准输出。本文将通过两大实战案例，从零带你完成自定义 Skill 开发、本地部署、工具调用，同时讲解插件市场技能安装、跨平台适配、问题排查等全套落地知识，零基础也能快速上手。

一、Skill 核心概念：重新定义 AI 执行能力

Skill 是适配全平台 AI Agent 的标准化执行规则文件，核心载体为 SKILL.md，通过固定的文件结构与语法，精准定义 AI 的执行逻辑，核心包含三要素：

  • 触发条件：明确 AI 什么时候需要启用当前技能
  • 执行步骤：规范 AI 具体操作流程、工具调用方式
  • 输出规范：统一结果格式、约束输出边界

其核心价值是完成 AI 能力升级：让原本被动应答的聊天助手，转变为可管控、可复用、可自动化的专业执行工具。同时 Skill 支持渐进式加载机制，仅在匹配到对应场景时加载完整内容，极大节省 Token 资源，避免上下文溢出。

二、新手实战 1：Claude Code 自定义 Python 规范技能

我们以实用的「Python 代码命名规范技能」为例，手把手完成首个自定义 Skill 的创建、部署与调用，适配 Claude Code 环境。

1. 目录创建规范

Skill 遵循「一技能一文件夹」原则，支持两种部署模式：全局全局生效、项目专属生效。本次以项目级部署为例，在项目根目录创建目录结构：

.claude/skills/python-naming-standard/
└── SKILL.md  # 技能核心配置文件

2. 编写完整 SKILL.md 配置

文件由 YAML 头部元数据 + Markdown 执行规则组成，元数据控制技能识别与触发，正文定义具体执行标准：

---
name: python-naming-standard
description: 当用户编写、审查、重构 Python 代码时自动启用，用于规范内部辅助函数命名
---

## 执行规则
1. 项目所有内部辅助函数，必须统一以 `_internal_` 作为前缀命名
2. 自动扫描代码，识别不符合命名规范的函数，主动给出精准修改建议
3. 执行代码提交（claude commit）操作前，强制校验本规范，杜绝不规范代码提交

## 参考示例
✅ 规范写法：def _internal_calculate_risk():
❌ 错误写法：def _calculate_risk():

3. 技能调用实战效果

在终端启动 Claude Code，输入任务指令：帮我写一个计算用户折扣的 Python 函数。Agent 会自动扫描本地所有 Skill，匹配到 Python 代码编写场景，自动加载本技能，最终生成符合规范的代码：

def _internal_get_discount(user_level):
    # 根据用户会员等级计算折扣逻辑
    if user_level == "VIP":
        return 0.8
    return 0.95

4. 技能拓展资源配置（可选）

复杂技能可在技能目录下新增拓展文件夹，实现能力升级，不改动核心逻辑：

  • examples/：存放场景示例文件，优化模型执行效果
  • references/：存放行业规范、业务参考文档
  • scripts/：存放可执行脚本，支撑复杂自动化操作

三、技能快速拓展：官方插件市场一键安装

除了手动自定义技能，可直接接入公共技能市场，一键安装成熟的官方技能集，快速解锁文档处理、设计、算法等能力。

1. 接入技能市场

在 Claude Code 终端执行命令，添加官方技能市场源：

/plugin marketplace add anthropics/skills

2. 安装预置技能集

市场内置两大核心技能合集，可按需安装：

  • document-skills：全品类文档处理技能，支持 Word、Excel、PPT、PDF 编辑与生成
  • example-skills：示例技能合集，覆盖算法设计、网页测试、视觉设计等场景

安装命令：

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

3. 插件技能使用方式

安装完成后重启 Claude Code，直接通过自然语言调用技能，例如输入：创建一个关于 AI Agent Skill 的演示 PPT，Agent 会自动匹配 PPT 生成技能，完成主题设计、排版、内容填充，自动生成标准化演示文档。

注：插件安装的技能默认存放于 ~/claude/plugins/marketplaces/ 目录，与本地自定义技能互不冲突。

四、新手实战 2：VS Code + GitHub Copilot 技能落地

Skill 为跨平台通用格式，除了 Claude Code，可直接适配 VS Code + GitHub Copilot 环境。我们以「掷骰子随机数技能」为例，完成全流程实战。

1. 环境准备

安装 VS Code 编辑器，搭配 GitHub Copilot、GitHub Copilot Chat 扩展，开启 Agent 智能执行能力。

2. 目录与文件创建

VS Code 固定读取 .agents/skills/ 目录下的技能文件，创建目录与配置：

.agents/skills/roll-dice/
└── SKILL.md

3. 跨平台技能完整配置

适配 macOS、Linux、Windows 多系统，实现通用随机掷骰子能力：

---
name: roll-dice
description: 用户要求掷骰子（d6、d20等）或生成随机骰子点数时使用，支持多系统终端执行
---

# 掷骰子执行方法
## macOS / Linux 执行命令
```bash
echo $((RANDOM % <sides> + 1))
```

## Windows PowerShell 执行命令
```powershell
Get-Random -Minimum 1 -Maximum (<sides>+1)
```

## 使用说明
1. 将占位符 <sides> 替换为对应骰子面数，d6 替换为6、d20替换为20
2. 执行后仅返回纯数字结果，无需多余解释
3. Agent 自动识别当前操作系统，匹配对应执行命令

4. 技能测试与调用

  1. 打开 VS Code Copilot Chat 面板，切换至 Agent 模式；
  2. 输入 /skills 命令，确认 roll-dice 技能加载成功；
  3. 输入指令 Roll a d20，Agent 自动匹配技能、执行终端命令、返回 1-20 随机点数。

5. 底层执行三大核心流程

  • 发现阶段：Agent 启动后扫描技能目录，仅预加载技能 name 和 description 信息；
  • 激活阶段：用户指令与技能描述匹配成功，加载完整 SKILL.md 执行规则；
  • 执行阶段：自适应系统环境，调用对应终端命令，完成任务并输出标准化结果。

五、Skill 通用强制规范（必记）

无论适配任何平台，Skill 均遵循统一标准，规范是技能精准触发、稳定执行的核心：

  1. 文件名固定：核心文件必须命名为 SKILL.md，大小写不可修改；
  2. 命名规范：name 仅支持小写字母、数字、连字符，无空格、无大写，需与文件夹名称完全一致；
  3. 描述精准原则：description 必须包含核心功能、适用场景、触发关键词，避免模糊描述导致误触发、漏触发；
  4. 固定结构：顶部 YAML 元数据定义身份与触发规则，下方 Markdown 定义执行步骤、示例与约束；
  5. 全平台通用：一份 Skill 可无缝适配 Claude Code、VS Code、OpenCode、OpenAI Codex 等所有兼容平台。

六、全平台技能存放目录对照表

不同 AI 工具默认技能读取目录不同，只需将技能放入对应路径即可自动生效：

运行工具技能存放目录
VS Code + GitHub Copilot.agents/skills/
Claude Code.claude/skills/、~/.claude/skills/
OpenAI Codex.codex/skills/

七、常见问题与精准排查方案

常见问题核心原因解决方案
技能列表无法识别 Skill文件路径错误、文件名大小写错误、目录与name不匹配核对目录路径，确保 SKILL.md 大写，文件夹名与技能name完全一致
技能加载成功但不触发description 描述模糊，无明确场景与关键词补充功能定位、适用场景、触发关键词，细化描述
技能命令执行失败系统环境不兼容、命令适配性差补充多平台执行脚本，区分 Windows、macOS、Linux 环境
插件技能不生效安装后未重启工具、插件源加载异常重启对应 AI 工具，重新执行插件加载命令

八、全文总结

AI Agent Skill 是打通大模型“对话能力”与“落地执行能力”的核心载体，彻底解决了传统 AI 输出不稳定、无规范、不可复用的痛点。

从实战落地角度来说，Skill 的核心优势可以总结为三点：

  1. 低门槛易上手：仅需简单 Markdown 语法，无需复杂编码，零基础即可自定义专属技能；
  2. 一次编写、全域复用：跨平台通用，支持手动自定义、市场一键安装两种部署方式；
  3. 工程化可沉淀：将个人、团队业务规范永久沉淀为 AI 能力资产，实现标准化自动化作业。

掌握 Skill 开发与部署，能够让 AI 彻底摆脱“人工反复引导”的模式，成为高效、稳定、可控的自动化工作助手。

参考链接

  1. AI Agent 第一个 Skill 入门教程：www.runoob.com/skills/skil…

  2. VS Code 创建与使用 Skill 教程：www.runoob.com/skills/vs-c…

avatar
文章
阅读
粉丝