cursor自带skills-使用指南

_院长大人_2026-07-04 10:26

title: cursor自带skills-使用指南

date: 2026-07-03 11:03:28

tags:

  • Cursor
  • Agent Skill
  • AI 编程
  • 使用指南
  • 代码审查
  • 自动化
  • Rules
  • Hooks

Cursor 内置 Skill 使用指南

本文档介绍 Cursor 自带的 Agent Skill 的作用、使用方式，以及每个 Skill 的示例。

内置 Skill 位于 ~/.cursor/skills-cursor/，由 Cursor 自动维护，请勿手动修改。

目录

  1. [Skill 是什么](#Skill 是什么)
  2. [如何使用 Skill](#如何使用 Skill)
  3. [Skill 与 Rule 的区别](#Skill 与 Rule 的区别)
  4. [内置 Skill 一览](#内置 Skill 一览)
  5. [各 Skill 详细说明与示例](#各 Skill 详细说明与示例)
  6. [自定义 Skill](#自定义 Skill)

1. Skill 是什么

Skill（技能） 是给 Cursor AI Agent 用的「操作手册」------一个目录 + 主文件 SKILL.md（YAML 元数据 + Markdown 正文），用来教 Agent 在什么场景下、按什么步骤完成特定任务。

对比项 普通对话 Skill
知识来源 模型通用能力 + 当前对话 预写好的流程、模板、团队规范
触发方式 用户说什么就做什么 根据 description 自动匹配，或用户显式调用
一致性 每次可能不同 同一 Skill 多次执行步骤更一致

工作机制：

  1. 发现 --- 系统将可用 Skill 的 name 和 description 注入 Agent 上下文
  2. 匹配 --- Agent 根据 description 中的「做什么（WHAT）」和「何时用（WHEN）」决定是否加载
  3. 执行 --- 匹配后读取完整 SKILL.md，按步骤、模板、脚本说明执行

2. 如何使用 Skill

2.1 三种触发方式

方式 说明 示例
斜杠命令 在 Agent 聊天框输入 /skill-name /review-bugbot、/loop 5m check CI
自然语言 描述需求，Agent 根据 description 自动匹配 「帮我审查当前分支的代码」
Agent 主动读取 执行相关任务前 Agent 自动加载对应 Skill 编辑 .canvas.tsx 时自动读 canvas skill

2.2 使用前提

  • 在 Agent 模式（非 Ask 模式）下使用，Agent 才能执行 Skill 中的工具调用
  • 部分 Skill 限定运行环境：
    • automate --- 需在 Agents Window 中运行
    • loop --- 不支持 Cloud Agent
    • canvas、update-cursor-settings --- 主要在 IDE 中使用
    • update-cli-config、statusline --- 主要在 CLI 中使用

2.3 斜杠命令格式

复制代码 
/skill-name [参数...]

带参数的 Skill 示例：

复制代码 
/loop 5m 检查 CI 状态
/shell git status
/onboard
/review-bugbot

3. Skill 与 Rule 的区别

Rule（规则） Skill（技能）
目的 持续约束 Agent 行为 完成特定任务的工作流
加载时机 常按文件类型/项目自动生效 按场景匹配或显式调用
存储位置 .cursor/rules/*.mdc ~/.cursor/skills/ 或 .cursor/skills/
类比 一直遵守的「规矩」 遇到某类任务时拿出来的「SOP」

4. 内置 Skill 一览

Skill 分类 作用简述
onboard 入门 引导新用户完成 Cursor onboarding
create-skill 配置 创建自定义 Skill
create-rule 配置 创建 Cursor Rules
create-hook 配置 创建 Cursor Hooks
create-subagent 配置 创建自定义子 Agent
migrate-to-skills 配置 将旧 Rule/Command 迁移为 Skill
review 代码审查 选择 Bugbot 或 Security Review
review-bugbot 代码审查 Bugbot 代码审查
review-security 代码审查 安全代码审查
babysit PR 管理 维护 PR 至可合并状态
split-to-prs PR 管理 拆分大改动为多个小 PR
canvas 可视化 生成 React 可视化面板
automate 自动化 创建 Cursor Automations
loop 自动化 周期性执行 prompt
sdk 开发集成 Cursor SDK 编程指南
shell 终端 直接执行 shell 命令
statusline CLI 配置 自定义 CLI 状态栏
update-cursor-settings IDE 配置 修改 settings.json
update-cli-config CLI 配置 修改 cli-config.json

5. 各 Skill 详细说明与示例

5.1 onboard --- 新用户引导

作用： 通过简短问答了解用户偏好，推荐第一个目标，并给出后续操作建议。

触发： 仅当用户显式调用 /onboard。

特点： 只收集信息并给出 handoff，不直接执行配置；一次只问一个问题。

使用示例：

复制代码 
/onboard

我是 Cursor 新用户，帮我 onboarding

预期行为： Agent 依次询问姓名、工作场景、首要目标等，最后给出个性化建议和下一步操作提示。

5.2 create-skill --- 创建自定义 Skill

作用： 指导创建个人或项目级 Skill，包括目录结构、description 写法、最佳实践。

触发： 提到「创建 skill」「写 SKILL.md」等。

使用示例：

复制代码 
帮我创建一个 Skill：当用户要求写 commit message 时，按 Conventional Commits 格式生成

我想把团队的 code review 流程做成一个 Skill，存到项目 .cursor/skills/ 里

SKILL.md 的 description 应该怎么写？

预期行为： Agent 询问用途、存储位置、触发场景，然后在 ~/.cursor/skills/ 或 .cursor/skills/ 下创建 Skill 目录和 SKILL.md。

5.3 create-rule --- 创建 Cursor Rules

作用： 在 .cursor/rules/ 创建持久化 AI 规则（编码规范、项目约定等）。

触发： 提到「创建 rule」「添加编码规范」「.cursor/rules/」等。

使用示例：

复制代码 
为这个项目创建一条 Rule：所有 Java Controller 必须使用 @Valid 校验 DTO

帮我写一条只在 **/*.dart 文件生效的 Flutter 规范 Rule

AGENTS.md 和 .cursor/rules/ 有什么区别？帮我创建合适的 Rule

预期行为： Agent 确认作用域（全局 / 文件模式），创建 .mdc 规则文件。

5.4 create-hook --- 创建 Cursor Hooks

作用： 在 Agent 事件前后运行自定义脚本或 prompt 检查（如拦截危险 shell 命令）。

触发： 提到「创建 hook」「hooks.json」「自动化 Agent 行为」等。

使用示例：

复制代码 
创建一个 hook：在执行 git push --force 之前弹出确认

在 Agent 编辑文件后自动运行 prettier 格式化

帮我写一个 beforeShellExecution hook，禁止 rm -rf /

预期行为： Agent 确定事件类型、作用域（项目/用户）、实现方式，创建 .cursor/hooks.json 和脚本。

5.5 create-subagent --- 创建自定义子 Agent

作用： 创建带专用 system prompt 的子 Agent，用于代码审查、调试等专项任务。

触发： 提到「创建 subagent」「自定义 agent」等。

使用示例：

复制代码 
创建一个专门审查 SQL 注入的子 Agent

帮我写一个 domain-specific 的 API 文档生成 agent，存到 .cursor/agents/

预期行为： Agent 在 .cursor/agents/ 或 ~/.cursor/agents/ 创建 .md 配置文件。

5.6 migrate-to-skills --- 迁移旧配置到 Skill

作用： 将「Applied intelligently」类型的 Rule（.mdc）和斜杠命令（.cursor/commands/*.md）转换为 Skill 格式。

触发： 显式调用或提到「迁移 rule 到 skill」。

使用示例：

复制代码 
/migrate-to-skills

把 .cursor/commands/ 下的斜杠命令都迁移成 Skill

我有几条 .mdc rule 想转成 Skill 格式，帮我迁移

预期行为： Agent 扫描可迁移文件，在 .cursor/skills/ 生成对应 SKILL.md（保留原文内容）。

5.7 review --- 代码审查（选择器）

作用： 让用户选择 Bugbot 或 Security Review，然后执行对应审查。

触发： 显式调用 /review。

使用示例：

复制代码 
/review

预期行为： Agent 弹出选项让你选择 bugbot 或 security，然后执行对应 Skill。

5.8 review-bugbot --- Bugbot 代码审查

作用： 启动 Bugbot 子 Agent，对当前分支改动做 bug/质量问题审查。

触发： /review-bugbot 或「用 Bugbot 审查代码」。

使用示例：

复制代码 
/review-bugbot

用 Bugbot 审查我当前分支相对 main 的所有改动

/review-bugbot
只审查未提交的本地改动

审查这个 PR：https://github.com/org/repo/pull/123

预期行为：

  • 默认审查「branch changes」（相对 base branch 的全部改动）
  • 输出 Severity / Location / Finding 表格
  • 不会自动修复，除非你明确要求

5.9 review-security --- 安全代码审查

作用： 启动 Security Review 子 Agent，专注安全漏洞（注入、XSS、密钥泄露等）。

触发： /review-security 或「做安全审查」。

使用示例：

复制代码 
/review-security

对当前未提交的改动做安全审查

/review-security
重点检查认证和权限相关代码

预期行为： 与 Bugbot 类似，但聚焦安全问题，输出按严重程度排序的发现列表。

5.10 babysit --- PR 维护

作用： 持续维护 PR 直至可合并：处理评论、解决冲突、修复 CI。

触发： 提到「babysit PR」「让 PR 可合并」等。

使用示例：

复制代码 
babysit 当前 PR，直到 CI 全绿且评论都处理完

这个 PR 有 merge conflict 和 CI 失败，帮我 babysit

处理 PR #42 上 Bugbot 的评论，修复有效问题

预期行为： Agent 检查 PR 状态 → 解决冲突 → 处理评论 → 修 CI → 循环直到 merge-ready。

5.11 split-to-prs --- 拆分 PR

作用： 将一大坨改动拆成多个独立、易 review 的小 PR。

触发： 提到「拆分 PR」「split changes」等。

使用示例：

复制代码 
我把太多改动堆在一个分支上了，帮我拆成 3 个 PR

/split-to-prs
当前改动包含 auth 重构和 UI 调整，拆成独立 PR

预期行为：

  1. 分析改动，提出拆分方案（含 Mermaid 依赖图）
  2. 等你批准后才创建分支、commit、push、开 PR
  3. 不会丢弃任何工作

5.12 canvas --- 可视化面板

作用： 生成 .canvas.tsx 文件，在聊天旁打开交互式 React 可视化面板。

适用场景： 数据分析、安全审计报告、架构审查、MCP 工具返回的结构化数据、图表表格等。

不适用： 写代码、修 bug、在特定外部工具里建 dashboard。

使用示例：

复制代码 
分析过去 7 天的 API 错误率，用 canvas 展示

把这次安全审查的发现做成可视化报告

对比 main 和 feature 分支的改动范围，用 canvas 画架构图

预期行为： Agent 在 ~/.cursor/projects/<workspace>/canvases/ 下创建 .canvas.tsx，并提供可点击链接在 IDE 中打开。

5.13 automate --- 创建 Cursor Automations

作用： 交互式创建 Cursor Automation（定时/触发式 Agent 任务）。

触发： 明确提到「Cursor Automation」「创建自动化」等（不是泛指 CI/GitHub Actions）。

使用示例：

复制代码 
创建一个 Cursor Automation：每天 9 点检查 main 分支 CI 状态

当 Slack #deploy 频道有人 @bot 时，自动跑 code review

帮我设置一个 Automation：PR 合并后发送 Slack 通知

预期行为： Agent 收集触发条件、工具、指令 → 展示草案表格 → 你确认后打开 Automations 编辑器。

注意： 需在 Agents Window 中使用；不支持 Cloud Agent。

5.14 loop --- 周期性执行

作用： 按固定或动态间隔重复执行 prompt（如轮询 CI、监控部署）。

触发： /loop [interval] <prompt>。

使用示例：

复制代码 
/loop 5m 检查 CI 状态，失败就告诉我

/loop 30s 监控 deploy 日志直到出现 "Deployment successful"

/loop 每 10 分钟运行一次测试套件

/loop 等待 PR #123 合并后再继续后续步骤

间隔格式： 30s、5m、2h、1d；也可省略间隔让 Agent 自行决定节奏。

停止： 告诉 Agent「停止 loop」即可。

注意： 不支持 Cloud Agent；Windows 上会用 PowerShell 等价语法。

5.15 sdk --- Cursor SDK 编程

作用： 指导使用 @cursor/sdk（TypeScript）或 cursor-sdk（Python）在代码中调用 Cursor Agent。

触发： 提到 SDK、Agent.create、CI 中跑 Agent 等。

使用示例：

复制代码 
用 @cursor/sdk 写一个脚本，对指定 repo 跑 code review

在 GitHub Action 里集成 cursor-sdk，PR 时自动审查

Agent.create 和 Agent.resume 有什么区别？

帮我 bootstrap 一个 Python cursor_sdk 集成，本地 runtime

预期行为： Agent 根据语言选型，给出可运行的集成代码和常见陷阱说明。

5.16 shell --- 直接执行 Shell 命令

作用： 将 /shell 后的文本原样作为 shell 命令执行，不做改写或解释。

触发： 仅显式调用 /shell。

使用示例：

复制代码 
/shell git status

/shell npm run build

/shell docker ps -a

预期行为： Agent 直接运行命令，报告 exit code 和关键输出。

5.17 statusline --- CLI 状态栏

作用： 配置 Cursor CLI 聊天框上方的自定义状态栏（显示 git 分支、模型名等）。

触发： 提到「statusline」「CLI 状态栏」等。

使用示例：

复制代码 
帮我配置 CLI statusline，显示当前 git 分支和 model 名称

在 ~/.cursor/cli-config.json 里加 statusLine 配置

预期行为： Agent 创建状态栏脚本并写入 ~/.cursor/cli-config.json 的 statusLine 字段。

配置示例：

json 复制代码 
{
  "statusLine": {
    "type": "command",
    "command": "~/.cursor/statusline.sh",
    "padding": 2
  }
}

5.18 update-cursor-settings --- 修改 IDE 设置

作用： 修改 Cursor/VSCode 的 settings.json（主题、字体、format on save 等）。

触发： 提到「改编辑器设置」「字体大小」「format on save」等。

使用示例：

复制代码 
把 Cursor 字体改成 14px，启用 format on save

设置 Java 文件的 tab size 为 4

开启 Cursor 的 vim 模式（IDE 设置）

预期行为： Agent 读取现有 settings，只修改你要求的项，保留其他配置。

Windows 路径： %APPDATA%\Cursor\User\settings.json

5.19 update-cli-config --- 修改 CLI 配置

作用： 修改 ~/.cursor/cli-config.json（权限、vim 模式、沙箱、显示选项等）。

触发： 提到「CLI 配置」「cli-config.json」「approval mode」等。

使用示例：

复制代码 
把 CLI 默认行为改成 agent 模式

在 CLI 里启用 vimMode

配置 CLI 权限：允许 Shell(**)，禁止 Mcp(dangerous-server, *)

预期行为： Agent 读取并更新 ~/.cursor/cli-config.json；项目级可用 .cursor/cli.json 覆盖。

6. 自定义 Skill

若内置 Skill 不满足需求，可创建自定义 Skill：

类型 路径 作用域
个人 ~/.cursor/skills/<skill-name>/SKILL.md 所有项目
项目 .cursor/skills/<skill-name>/SKILL.md 当前仓库（可共享给团队）

最小结构：

markdown 复制代码 
---
name: my-skill-name
description: 做什么。Use when 用户提到 xxx 或需要 yyy 时。
---

# My Skill Name

## 步骤
1. ...
2. ...

创建方式：

复制代码 
帮我创建一个 Skill：...

或直接调用 create-skill 相关对话，Agent 会按规范帮你创建。

附录：快速参考表

我想... 用这个 Skill 示例命令
新用户入门 onboard /onboard
审查 bug review-bugbot /review-bugbot
审查安全 review-security /review-security
选审查类型 review /review
维护 PR babysit babysit 当前 PR
拆分大 PR split-to-prs 帮我把改动拆成多个 PR
可视化报告 canvas 用 canvas 展示分析结果
定时任务 loop /loop 5m check CI
创建自动化 automate 创建 Cursor Automation...
直接跑命令 shell /shell git status
SDK 集成 sdk 用 cursor-sdk 写脚本...
改 IDE 设置 update-cursor-settings 字体改成 14px
改 CLI 配置 update-cli-config CLI 启用 vim 模式
自定义状态栏 statusline 配置 CLI statusline
创建 Rule create-rule 创建 Java 编码规范 Rule
创建 Hook create-hook 创建 shell 拦截 hook
创建 Skill create-skill 帮我创建一个 Skill
创建子 Agent create-subagent 创建 SQL 审查 subagent
迁移旧配置 migrate-to-skills /migrate-to-skills

文档版本：2026-07-03 · 基于 Cursor 内置 skills-cursor 目录整理

相关推荐
Java陈序员1 天前
一站式本地监控！一款开源的 Token 用量监控分析工具！
ai编程·claude·cursor
牧艺1 天前
Cursor Rules / Skills 分层设计：让 Agent 像「团队新同事」
前端·人工智能·cursor
TrisighT1 天前
DevEco Code 写鸿蒙 ArkTS 确实快，但我试了三天后把默认引擎换成了 Cursor
ai编程·harmonyos·cursor
浩风祭月2 天前
AI 改代码总爱顺手重构？一份 Task Contract 把修改范围锁住
ai编程·claude·cursor
universeplayer8 天前
天天用 Claude Code 和 Codex，但你比过它们在你自己的活上谁更强吗？我写了个工具让它们同台开打
ai编程·claude·cursor
乘风gg9 天前
当 AI 遇到私有组件，Cli 才是 AI Coding 的起点
前端·ai编程·cursor
用户46182495981910 天前
SSH 反向隧道 + Claude MCP SSH 服务接入完整部署文档
cursor
乘风gg10 天前
AI GenUI 真正落地时，前端到底要做什么？
前端·ai编程·cursor
武子康11 天前
调查研究-190 Continue.dev 被 Cursor 收购：AI 编程工具正从“插件竞争“迈入“平台整合“阶段
人工智能·ai编程·cursor
热门推荐
012026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf02GitHub 镜像站点03【AI】2026 年具身智能模型和世界模型总结04AI科技热点日报 | 2026年07月01日052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？072026 年 AI 大模型 & AI 编程工具实战全总结08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析092026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？10Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费