AI 工具文章更新：2026年3月8日 4 分钟阅读

AI Agent Skills 指南

理解 skills 的作用、目录结构、编写方式，以及它与 MCP 的关系

目录 16 节

AI Agent Skills 指南

在越来越多的 AI Agent 工作流里，skills 用来把可复用的方法、操作步骤、脚本和参考资料打包成一个长期可维护的能力单元。

相比每次都重新写一段很长的 Prompt，skills 更适合那些会被反复执行、而且步骤相对稳定的任务。

什么是 Skill

一个 skill 通常包含：

一份核心说明文档，例如 SKILL.md
必要时配套的 scripts/、references/、assets/ 或模板文件
清晰的触发条件、适用范围和输出要求

常见用途：

安装和初始化某一类开发环境
代码审查、排错、重构、发布检查
调用固定脚本生成报告、文档或配置
把团队经验沉淀成可复用流程

什么时候应该先写成 Skill

如果你在团队里反复遇到下面这些情况，通常就该考虑沉淀成 skill：

每次做同一类任务都要先解释一遍背景和约束
流程里已经有固定脚本、模板、检查清单或输出格式
任务本身不复杂，但很依赖执行顺序和细节
同一个问题由不同人来做时，结果质量波动很大

Skills 和 MCP 的关系

skills 和 MCP 经常一起出现，但它们职责不同：

维度	Skills	MCP
核心作用	复用步骤与知识	连接工具与数据
主要形式	Markdown、脚本、模板	Server、资源、工具接口
典型场景	发布 SOP、编码规范、排障流程	GitHub、数据库、浏览器、Docker、搜索

一句话总结：

Skill 负责“怎么做”
MCP 负责“能做什么”

这也是为什么很多成熟的 Agent 工作流，都会同时维护一套 skills 和一组 MCP Servers。

典型目录结构

skills/
  release-check/
    SKILL.md
    scripts/
      run.ps1
    references/
      checklist.md
    assets/
      template.md

一个简单的 SKILL.md 通常会说明：

什么时候触发这个 skill
执行时先看哪些文件或配置
要优先使用哪些脚本或模板
成功输出应该长什么样

示例

# Release Check

适用于发布前检查。

流程：
1. 读取 changelog 与 package.json
2. 运行测试与构建
3. 按 references/checklist.md 输出检查结果

这个 skill 本身并不一定直接拥有“执行权限”，但它会告诉 Agent 在什么前提下该读哪些文件、调用哪些脚本、输出怎样的结果。

一个更实用的 `SKILL.md` 骨架

# Skill Name

## 什么时候使用
- 用户明确提到某个工具、平台或场景
- 仓库中出现特定文件、依赖或错误特征

## 先看什么
- `README.md`
- `package.json`
- `scripts/check.ps1`

## 执行顺序
1. 读取关键配置
2. 优先运行已有脚本
3. 必要时再补最小代码修改
4. 输出结果摘要与后续建议

## 输出要求
- 先给结论
- 再列出改动文件
- 最后给验证命令

## 不要做什么
- 不要绕过现有脚本另起炉灶
- 不要修改无关模块