القائمة
简短说明：这个技能做什么、什么时候用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| title | Skill 使用介绍（Cursor / Codex Agent Skills） |
| tags | ["AI","Agent","Skill"] |
Agent Skills 是一套开放标准，用于为 AI 代理扩展领域能力。本文介绍在 Cursor、Codex 等环境中如何发现、安装、使用和自建 Skill。参考 Cursor 官方文档 与 Agent Skills 开放标准。内容与示例基于 Cursor 2.x 及开放生态（2025–2026 主流实践），Cursor 2.0+ 起完整支持 Agent Skills。
适用读者：已在使用 Cursor、Codex 或支持 Agent Skills 的 IDE/平台，希望为 Agent 增加可复用流程与规范的开发者或进阶用户。
Skill（技能） 是一个可移植、可版本控制的「能力包」，用来教 Agent 如何完成某一类具体任务。它可以包含：
SKILL.md 里写清何时用、怎么用、步骤与规范references/、assets/ 中，按需加载与 MCP（模型上下文协议） 的定位不同：MCP 定义的是「模型如何连接外部工具/数据源」的协议与接口；Skill 定义的是「在何种场景下、按何种步骤、使用何种脚本或规范」完成任务。二者互补：MCP 提供「能力通道」，Skill 提供「使用规范与流程」。
| 特点 | 说明 |
|---|---|
| 可移植 | 支持 Agent Skills 标准的任何代理都能用同一套 Skill |
| 可版本控制 | 以文件形式存在，可放进 Git 仓库或通过 GitHub 安装 |
| 可执行 | 可包含脚本、模板，Agent 能按说明调用工具执行 |
| 按需加载 | 资源渐进加载，有利于控制上下文长度 |
Cursor / Codex 会在以下目录自动发现 Skill（每个 Skill 是一个文件夹，且内含 SKILL.md）：
| 路径 | 作用域 |
|---|---|
.cursor/skills/ | 当前项目 |
.codex/skills/ | 当前项目（Codex 兼容） |
.claude/skills/ | 当前项目（Claude 兼容） |
~/.cursor/skills/ | 用户全局 |
~/.codex/skills/ | 用户全局 |
~/.claude/skills/ | 用户全局 |
Agent 启动时会扫描这些目录，根据当前对话上下文自动判断是否启用某个 Skill；你也可以在对话里手动调用（见下文）。
/，会弹出可用的 Skill 列表，搜索并选择即可。/skill-name 或 $skill-name 直接指定要用的技能（视具体产品而定）。Cmd+Shift+J，Windows/Linux：Ctrl+Shift+J）Agent Skills 开放生态 提供用命令行管理 Skill 的方式：
# 按关键词搜索 Skill
npx skills find [关键词]
# 安装整个技能库或指定技能（二选一）
npx skills add vercel-labs/agent-skills -g -y
npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices -g -y
# 检查/更新已安装 Skill
npx skills check
npx skills update
# 列出已安装技能
npx skills list
-g 表示装到用户目录（全局），-y 表示跳过确认。也可用 --skill <名称> 只安装仓库中的某一个技能。该 CLI 支持 Cursor、Codex、Claude Code 等 30+ 种 Agent；若不想上报匿名使用统计，可设置环境变量 DISABLE_TELEMETRY=1。安装后一般需要重启 Cursor/Codex 才能识别新 Skill。
SKILL.md 的 Skill 文件夹复制到上面任一「Skill 目录」即可，例如：
<项目根>/.cursor/skills/my-skill/~/.cursor/skills/my-skill/ 或 ~/.codex/skills/my-skill/每个 Skill 必须有一个 SKILL.md，且带有 YAML 前置元数据。
---
name: my-skill
description: 简短说明：这个技能做什么、什么时候用。
---
# My Skill
给 Agent 看的详细说明。
## When to Use
- 当用户需要……时使用
- 适合用来……
## Instructions
- 步骤一
- 步骤二
- 若需和用户确认，可使用提问类工具
| 字段 | 必填 | 说明 |
|---|---|---|
name | 是 | 技能标识，必须仅含小写字母、数字与连字符，且必须与所在文件夹名一致（否则可能无法被正确识别） |
description | 是 | 一句话说明用途与适用场景，供 Agent 判断是否采用 |
license | 否 | 许可证名称或引用 |
compatibility | 否 | 环境要求（如系统依赖、网络等） |
disable-model-invocation | 否 | 设为 true 时，只有用户显式输入 /skill-name 时才会加入上下文，不会自动被 Agent 选用 |
若希望某个 Skill 像传统「斜杠命令」一样，仅在被明确输入时才生效，在 frontmatter 里加上：
disable-model-invocation: true
除了 SKILL.md，还可以在同一个 Skill 目录下增加可选子目录：
| 目录 | 用途 |
|---|---|
scripts/ | 可执行脚本（如 deploy.sh、validate.py），在 SKILL.md 里用相对路径引用 |
references/ | 补充文档，按需被 Agent 加载 |
assets/ | 静态资源（模板、配置、图片等） |
示例结构：
.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│ ├── deploy.sh
│ └── validate.py
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
在 SKILL.md 里用相对路径说明如何调用脚本，例如：
## Usage
运行部署脚本：`scripts/deploy.sh <环境>`，其中 `<环境>` 为 staging 或 production。
部署前请先执行校验：`python scripts/validate.py`
Agent 会按你的说明在合适时机执行这些脚本。
自 Cursor 2.4 起引入 Agent Skills；若你之前用 Cursor 的「动态规则」（.cursor/rules/*.mdc）或「斜杠命令」（.cursor/commands/*.md），可用内置迁移能力转成 Skill：
/migrate-to-skills.cursor/skills/ 下生成对应 Skilldisable-model-invocation: true 的 Skill，保持「仅手动调用」的行为迁移完成后检查 .cursor/skills/ 里的内容，按需微调 SKILL.md。
description 是否清晰描述了适用场景，便于模型做相关性判断；或改用 disable-model-invocation: true 后通过 /skill-name 手动调用。scripts/ 下文件有执行权限，且 SKILL.md 中引用的路径为相对路径、与目录结构一致。npx skills find/add/list 等）.curated 等，可用 skill-installer 类 Skill 或文档说明的方式安装.cursor/skills/ 或 ~/.codex/skills/ 等目录后，可被自动选用，或在对话里用 / + 技能名手动调用。npx skills add、或直接复制 Skill 文件夹到上述目录。SKILL.md（必含 name、description），需要时可加 scripts/、references/、assets/。把 Skill 和 MCP、RAG 一起用：MCP 负责「连工具」，RAG 负责「查知识」，Skill 负责「定流程与规范」，三者结合能更稳定、可复现地用好 AI 代理。
延伸阅读：What is MCP（协议与工具连接）、RAG 技术（知识增强）、AI Agent 入门（Agent 组成与实战）。