type
status
date
slug
summary
tags
category
icon
password
在 AI 编程助手越来越强大的今天，一个核心问题浮出水面：
如何让 AI 不只是「会写代码」，而是「按照你的方式写代码」？
.cursorrules 解决了编码风格问题，AGENTS.md 约束了行为边界，但还有一个更强大的武器 —— Agent Skill。🎯 什么是 Agent Skill？
简单理解
Agent Skill 是 Cursor 中的 可复用知识库 + 工作流模板，
它把专业领域的知识、最佳实践、工作流程打包成 AI 可以直接调用的「技能包」。
核心定位：
- 专业能力注入：让 AI 具备特定领域的专业知识和判断力
- 工作流自动化：把复杂任务拆解成标准化的执行步骤
- 知识资产化：把团队经验、行业规范变成可复用的 AI 资产
与 .cursorrules 的区别
特性 | .cursorrules | Agent Skill |
作用范围 | 编码风格、技术偏好 | 专业能力、工作流程 |
触发方式 | 自动注入所有对话 | 按需自动识别触发 |
内容类型 | 规则、约束 | 知识库、步骤、示例 |
适用场景 | “怎么写代码” | “做什么、怎么做” |
举个例子：
.cursorrules说：
“用 Swift，别用 Objective-C”
- Agent Skill 说：
“当用户要设计 UI 时，先检索设计规范，再生成符合行业标准的代码”
📋 Agent Skill 的核心结构
文件组织
每个 Skill 是一个目录，包含
SKILL.md 主文件：存储位置
类型 | 路径 | 作用范围 |
个人 Skill | ~/.cursor/skills/skill-name/ | 所有项目可用 |
项目 Skill | .cursor/skills/skill-name/ | 仅当前项目 |
⚠️ 重要：不要创建在
~/.cursor/skills-cursor/，这是 Cursor 内置技能目录。SKILL.md 基本结构
每个 Skill 必须有一个
SKILL.md 文件，包含 YAML 前置信息和 Markdown 内容：🔧 如何创建你的第一个 Skill
场景：创建一个代码审查 Skill
🎬 实际情况
团队代码审查标准不统一，AI 审查时经常漏掉关键问题。
💡 创建步骤
Step 1：创建目录结构
Step 2：编写 SKILL.md
Step 3：重启 Cursor
创建完成后，重启 Cursor 让它扫描新的 Skill。
Step 4：验证使用
在 Cursor 中直接说：
“帮我审查一下这段代码”
AI 会自动调用这个 Skill。
💡 实战案例：PDF 处理 Skill
场景需求
经常需要从 PDF 提取文本、表格，但每次都要重新写代码。
完整 Skill 实现
目录结构
SKILL.md 内容
🎨 高级技巧：让 Skill 更智能
技巧 1：写好 Description
Description 是 Skill 的“触发器”，AI 用它决定什么时候调用这个 Skill。
关键点：
- 用第三人称
- 同时描述 做什么 + 什么时候用
- 包含触发关键词
技巧 2：使用渐进式披露
主文件保持简洁（< 500 行），详细内容放在引用文件中：
技巧 3：提供具体示例（对比）
技巧 4：包含工具脚本
优势：
- 更可靠
- 节省 token
- 保证一致性
🚀 总结
Skill 是 AI 编程的新范式。
- 把经验变成可复用能力
- 把复杂流程变成自动化
- 把 AI 从“能用”升级为“专业”
最后更新：2026-01-28
上海 汇金路地铁站 KFC
Catalog