---

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 是什么
2. 如何使用 Skill
3. Skill 与 Rule 的区别
4. 内置 Skill 一览
5. 各 Skill 详细说明与示例
6. 自定义 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 字段。

配置示例：

{
  "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	当前仓库（可共享给团队）

最小结构：

---
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 目录整理