Cursor具体使用
VSCode(全称：Visual Studio Code)，微软出品、免费开源、跨平台轻量代码编辑器(Windows/Mac/Linux 都能用)，VSCode标准界面如下：
简单理解：高级升级版记事本，专门用来写代码，比系统记事本强非常多，几乎支持所有编程语言。
第⼀部分：快速⼊⻔
1、Cursor 介绍与安装
Cursor 是⼀款基于 VSCode 的 AI 驱动代码编辑器，LLM+Harness=Agent，主要特点：
2. 界⾯与基本操作
2.1 主界⾯布局
2. 界⾯与基本操作
2.3 模式介绍
Cursor 提供多种⼯作模式：
Agent和Ask用的多一些，High比较耗token，Settings->Plan & Usage，能查看cursor的使用，如下图：
选中一段代码，按住Ctrl+K也可以对选中的代码进行操作
3. Agent 模式核⼼⽤法
3.1 打开 Agent 快捷键：
Cmd/Ctrl + L
侧边栏：点击 Agent 图标
右键菜单：选中代码 →"Ask Cursor"
3.2 @ 符号使⽤(核⼼技能)
@ 符号是与 Agent 对话的关键，⽤于精确引⽤内容：
可以@+文件/目录/rules，代码发生变化，可以Keep(保存)或Undo(撤销/回滚，要二次确认)
3.4 代码编辑基础
4. 核⼼快捷键与提示词
安装一个插件，SpecStory。SpecStory是VSCode/Cursor 的免费插件，核心定位：保存、导出、检索 AI 编程聊天记录(Copilot、Cursor Composer、Claude Code 等)。
后台静默运行，自动把和Copilot/Cursor的聊天保存到项目目录 .specstory/history/，格式为 Markdown，支持Git管理，包含完整对话、代码块、diff 修改记录docs.specs
5.【实战】贪吃蛇游戏(Python)
通过制作贪吃蛇游戏，掌握 Cursor 基本使⽤。新建一个文件夹，如cursor-game-1，打开该文件夹，如下图：
输入提示词创建一个贪吃蛇游戏，用python，运行python snake_game.py，贪吃蛇的小游戏出来了，很激动，如下图：
snake_game.py代码已保存到本地D:\cursor-game-1\snake_game.py，且生成了一个贪吃蛇游戏设计规格说明书，D:\cursor-game-1\.specstory\history\2026-08-19_07-26-31Z-python-snake-game-creation.md文件。主agent和子agent，它俩上下文不共享，子agent专注于干活，没有污染，节省token，子agent干完把产出的东西交给主agent就完事了。如果当前的任务之间没有关联，就用这种方式。
安装Superpowers：
1、在Cursor的聊天框里输入，帮忙装一下Superpowers，如果已安装就不用安装了，按照提示就可以安装成功了
2、查看Superpowers是否已安装，Ctrl+Shift+J，然后Open Customize，在搜索里输入Superpowers，能搜出来就代表安装成功
Superpowers的核心作用：
一句话定位：Cursor 负责写代码干活；Superpowers 负责定开发流程、控质量门禁；SpecStory负责保存聊天记录。
using-superpowers → brainstorming(方案设计确认)→ writing-plans(拆任务)→ executing /subagent 开发 → TDD 测试 → code review → verification-before-completion 完工校验
/using-superpowers：前置能力初始化、权限与工具开关，准备环境，定义 Agent 能干什么、不能干什么，后续所有环节都依赖这里开放的能力
/brainstorming：需求翻译 + 多方案头脑风暴 + 选定技术方案
/writing-plans：把整体方案拆成可执行、有序、可追踪的原子任务。区别：brainstorming是做什么方案；writing-plans是一步一步怎么干。
executing /subagent 开发：executing：主 Agent 亲自执行简单任务(写短代码、改配置、查询文档)；subagent：复杂、独立的子任务，子Agent去开发，支持委托子代理并行/串行开发，任务落地执行(解耦，防止主上下文膨胀)
/TDD(test-driven-development)：测试驱动，保障实现符合预期，提前捕获 bug。TDD=先写测试用例，再实现功能(Agentic Coding 标准实践)
/code review：代码质量、规范、安全、架构合规检查
/verification-before-completion：整体集成验收，全链路校验，确认交付物完整可用
第二部分：进阶技能
6. Cursor Rules 详解
6.1 什么是 Rules
Rules 是向 AI 提供持久化、可复⽤上下⽂的⽅式。作⽤：
统⼀代码⻛格
提供项⽬上下⽂
减少重复说明
团队协作规范
rules和skills下面可以再建层级，Cursor Rules会把输入的用户提示词存到系统提示词里面，会浪费token，.cursorrules现在不用了，但也兼容。两种方式创建rules，第一种就是在chat窗口里输入/create-rule，提示词如：/create-rule 基于我们当前项目，帮我创建一个rule；也可以Ctrl+Shift+P，新建一个rule，如下图：
cursor官方文档，rules和skills里文件不能超过500行，以第一种为例
6.2 Rules 类型
Cursor ⽀持三种类型的 Rules，各有不同的存储位置和作⽤范围：
优先级：项目Rules > 团队Rules > 用户Rules。
项目Rules架构如下：
以第一种方式创建一个rule，创建完成后在rules目录下生成一个以.mdc为后缀的文件，mdc和md都可以。在该文件最上面可以看到如下：
description: 一句话说明用途
globs: "**/*.py"，globs是通配符的意思，仅当涉及 .py ⽂件时带⼊
alwaysApply: false，就是是不是把用户提示词加到系统提示词，默认就是false，节省token，如果写成true，globs就不用写了。有时写成false，globs也没写，可以在chat里输入@XX.mdc文件，也会把文件里的内容写到系统提示词里。
生成的mdc文件，自己最好看一下，有没有不合理的地方
7. 上下⽂管理五种⽅法
8. Cursor 降智问题及解决⽅案
8.1 什么是"降智"
AI 回答质量下降的现象：
回答变得简单、不完整
忽略重要细节
代码质量下降
8.2 解决⽅案
⽅案⼀：切换模型
⽅案⼆：清理上下⽂
点击 "New Chat" 开始新对话，清除累积的错误信息。
⽅案三：优化提示词
⽅案四：分解任务
9.【实战】浏览器插件开发-金句剪存插件：
9.1 项⽬需求
创建 Chrome 插件：⾦句剪存(⽂字剪存)⼯具
功能需求：
在⽹⻚上选中⽂字后，右键出现插件⼊⼝「剪存⽂字」，点击即可剪存到插件⾯板
插件⾯板可暂存多次剪存的⽂字(仅前端临时存储)；每次剪存的内容换⾏显示，区分不同轮次
插件⾯板提供「⼀键复制」按钮：将当前⾯板中所有剪存⽂字⼀次性复制到剪贴板
插件⾯板提供「⼀键清除」按钮：清空⾯板内所有剪存⽂字，不持久化保存
⾯板 UI 参考 Apple Design ⻛格(MVP 版本可暂不配置各类 icon)
9.2 创建项⽬ Rules
创建一个文件夹，如金句剪存-1，打开文件夹，新建一个rule，如.cursorrules，将以下浏览器插件开发规范放⼊其中，供Agent 在开发时⾃动遵循：
---
description: Chrome 浏览器插件开发规范
globs: ["**/*.js", "**/*.json", "**/*.html", "**/*.css", "**/*.jsx", "**/*.tsx"]
alwaysApply: true
---
# ⻆⾊
你是⼀名精通 **Chrome浏览器插件开发** 的⾼级⼯程师，拥有10年以上的 **浏览器扩展** 开发经验，熟悉 **J
# ⽬标
你的⽬标是以⽤户容易理解的⽅式帮助他们完成 **Chrome浏览器插件** 的设计和开发⼯作，确保应⽤功能完善、性能
# 要求
在理解⽤户需求、设计UI、编写代码、解决问题和项⽬迭代优化时，你应该始终遵循以下原则：
## 项⽬初始化
- 在项⽬开始时，⾸先仔细阅读项⽬⽬录下的 README.md ⽂件并理解其内容，包括项⽬的⽬标、功能架构、技术栈和
- 如果还没有 README.md ⽂件，请主动创建⼀个，⽤于后续记录该应⽤的功能模块、⻚⾯结构、数据流、依赖库等信
## 需求理解
- 充分理解⽤户需求，站在⽤户⻆度思考，分析需求是否存在缺漏，并与⽤户讨论完善需求；
- 选择最简单的解决⽅案来满⾜⽤户需求，避免过度设计。
## UI和样式设计
- 使⽤现代UI框架进⾏样式设计（例如 **React** 或 **Vue.js**，遵循 **Material Design** 或 **Chro
- 在不同平台上实现⼀致的设计和响应式模式。
## 代码编写
- **技术选型**：根据项⽬需求选择合适的技术栈（例如 **JavaScript** ⽤于主要开发语⾔，**HTML** ⽤于构
- **JavaScript**：⽤于主要开发语⾔，遵循⾯向对象编程原则，确保代码结构清晰。
- **HTML**：⽤于构建⻚⾯结构，遵循语义化标签原则，确保⻚⾯结构清晰。
- **CSS**：⽤于样式设计，遵循模块化样式原则，确保样式易于维护。
- **Chrome Extensions API**：⽤于浏览器扩展功能，遵循 Chrome 扩展开发规范，确保功能实现符合浏览器要
- **Webpack**：⽤于模块打包，遵循模块化开发原则，确保代码结构清晰且易于维护。
- **代码结构**：强调代码的清晰性、模块化、可维护性，遵循最佳实践（如 DRY 原则、最⼩权限原则、响应式设计
- **代码安全性**：在编写代码时，始终考虑安全性，避免引⼊漏洞，确保⽤户输⼊的安全处理。
- **性能优化**：优化代码的性能，减少资源占⽤，提升加载速度，确保项⽬的⾼效运⾏。
- **测试与⽂档**：编写单元测试，确保代码的健壮性，并提供清晰的中⽂注释和⽂档，⽅便后续阅读和维护。
## 问题解决
- 全⾯阅读相关代码，理解 **Chrome浏览器插件** 的⼯作原理；
- 根据⽤户的反馈分析问题的原因，提出解决问题的思路；
- 确保每次代码变更不会破坏现有功能，且尽可能保持最⼩的改动。
## 迭代优化
- 与⽤户保持密切沟通，根据反馈调整功能和设计，确保应⽤符合⽤户需求；
- 在不确定需求时，主动询问⽤户以澄清需求或技术细节；
- 每次迭代都需要更新 README.md ⽂件，包括功能说明和优化建议。
## ⽅法论
- **系统2思维**：以分析严谨的⽅式解决问题。将需求分解为更⼩、可管理的部分，并在实施前仔细考虑每⼀步。
- **思维树**：评估多种可能的解决⽅案及其后果。使⽤结构化的⽅法探索不同的路径，并选择最优的解决⽅案。
- **迭代改进**：在最终确定代码之前，考虑改进、边缘情况和优化。通过潜在增强的迭代，确保最终解决⽅案是健壮
9.3 ⽣成插件代码
在 Agent 中输⼊：
请帮我开发⼀个“⽂字剪存”Chrome浏览器插件，这个插件的功能是：
1、打开插件后，⽤户在⽹⻚上选中⽂字后，⿏标右键可以打开插件⼊⼝“剪存⽂字”，点击插件后就会剪存到插件⾯板中
2、插件⾯板可以储存(只是前端的短暂储存)多次剪存的⽂字；每次剪存进⾯板的⽂字需要换⾏，以区分不同轮次的剪
3、插件⾯板，有个"⼀键复制"按钮和"⼀键清除"按钮
4、⼀键复制，可以将之前剪存的⽂字都⼀键复制出来
5、⼀键清除，可以将之前剪存的⽂字都清除，不做保存
插件⾯板参考Apple Design⻛格(MVP版本的插件可以先不配置各种icon)
请遵循 @.cursor/rules/chrome-extension.mdc 规范
加载方式： chrome://extensions → 开发者模式 → 加载已解压的扩展程序 → 选项目根目录 d:\金句剪存-1。如下图：
如果上图有报错，把错误复制到cursor里，帮忙修复一下，然后点击一下刷新按钮即可，然后找到文本，右键点击剪存文字，就把选中的文字放到文字剪存的插件里了，可以多剪存几次，点开插件可以看到剪存的文字，如下图：
同时有一键复制和一键清除的功能，均可以实现，但是现在没有图标，在cursor里输入目前缺少图标，你帮我把图标添加上。执行完了，点一下刷新，图标出现了，如下图：
第三部分：⾼级功能
11. Cursor Command 介绍
11.1 什么是 Command
Command 是⾃定义的可复⽤⼯作流，通过 / 前缀触发。
在cursor里通过/出来的命令，有command，也有skills。在.cursor下新建一个文件夹，commands，在该目录下创建的md文档就是一个command。首先command不可能被cursor或ai agent自动加载进去，必须通过/命令手动触发。
11.2 存储位置
.md文件名字就是command的名字，command只有一个文件，不像skills有多个。把常用的提示词或流程封在一个command里，在command目录下新建一个文件，review12.md，把内容粘进去，如下：
---
name: review12
description: 审查代码
---
请审查以下代码，检查：
1. 代码质量和可读性
2. 潜在的 bug
3. 性能问题
4. 安全问题
给出具体的改进建议。
新开一个agent，输入 /review12 帮我review当前代码，执行完出现代码质量和可读性、潜在bug、性能和安全等。
codex没有command，cursor和Claudecode有command，codex要是用转成skills，command可以转成skills，skills转成command比较困难。
12. Cursor Skill介绍
12.1什么是Skill
Skill 是 Cursor 中更⾼级的⾃定义能⼒，⽤于教会 Agent 如何执⾏特定任务，手册的内容就是skill。与 Rules、Command 的区别如下：
12.2 存储位置
注意：~/.cursor/skills-cursor/ 是Cursor 内置Skill ⽬录，由系统管理，不要在此创建⾃⼰的Skill。
12.3 Skill ⽬录结构
每个 Skill 是⼀个⽬录，必须包含 SKILL.md ，可选的参考⽂件和脚本：
12.4 SKILL.md 基本格式
每个 Skill 的⼊⼝是 SKILL.md ，需包含 YAML frontmatter 和 Markdown 正⽂：
--
name：your-skill-name
description：简短描述这个技能做什么、在什么情况下使⽤，ai做不做取决于描述
--
#
技能名称
##
使⽤说明
分步骤的清晰指引。
##
示例
具体使⽤示例。
skill的description很重要，干了什么事情，实现了什么功能。name和description codex、ClaudeCode和Cursor都有，还有其他的东西，不一样。
给AI Agent提供了一个任务，它会把所有skills里的name和description都拉进去，它会根据description去描述匹配，可能是一个也可能是几个，如果要用到这个skill，才会去加载skill里面的内容，所以skill是渐进式披露，再说了skill里面有许多reference，也不是都加载进去。读skill.md的内容时，当某种情况下使用这个文档，某种情况下使用那个文档，这时才会读取reference里面的内容，很大程度上优化了它的上下文，节省了token。
12.5 写好 description(被发现的关键)
description 决定 Agent 何时会选⽤你的 Skill，建议：
1. ⽤第三⼈称（会注⼊系统提示）
✅"处理 Excel ⽂件并⽣成报告"
❌"我可以帮你处理 Excel"
2. 具体 + 触发词
✅"从 PDF 提取⽂本和表格、填表、合并⽂档。在⽤户处理 PDF、表单或⽂档提取时使⽤。"
❌"处理⽂档"
3. 同时写清「做什么」和「何时⽤」
做什么：具体能⼒
何时⽤：触发场景(如：审查 PR、写提交信息、处理 .xlsx)
示例：
# 代码审查
description: 按团队标准审查代码质量、安全与可维护性。在审查 PR、查看代码变更或⽤户要求代码审查时使⽤。
# 提交信息
description: 根据 git diff ⽣成描述性提交信息。在⽤户请求帮忙写提交信息或查看暂存变更时使⽤。
# API 集成
description: 快速集成第三⽅API：分析⽂档、创建客户端、认证与错误处理。在⽤户提到API 集成、接⼝对接时
12.6 写作原则
简洁：上下⽂要分给对话、其他 Skill，只写 Agent 真正缺少的信息，核心内容不缺。
SKILL.md 建议不超过 500 ⾏：详细内容放到 reference.md、examples.md ，需要时再读。
渐进式披露：核⼼步骤写在 SKILL.md；完整 API、⻓示例放在单独⽂件，并在正⽂中注明「详⻅reference.md」。
⾃由度要合适：多解任务⽤⽂字说明即可；容易出错的操作(如迁移脚本)可给出具体命令或脚本。
代码能够干的活优先用代码干，运行脚本的过程不费token，因为这运行的是一个命令，但是运行的结果会给到agent，agent识别的时候会费一些token。下次大模型请求时加到系统提示词里在运行时就费token。
ai有不确定性，用ai帮你生成代码，第一次费token，下次再用代码时就不费了，把脚本放到skill里去运行，skill也会节省很多token。
12.7 常⻅模式
模板模式——规定输出格式：
## 报告结构
使⽤以下模板：
# [分析标题]
## 摘要
[⼀段话概述]
## 发现
- 发现 1 + 数据
- 发现 2 + 数据
##
建议
1. 可执⾏建议 1
2. 可执⾏建议 2
示例模式——⽤输⼊/输出示范，有示例最好了，AI能推出很多东西：
## 提交信息格式
示例 1：
输⼊：添加了 JWT ⽤户认证
输出：feat(auth): implement JWT-based authentication
Add login endpoint and token validation middleware
示例 2：
输⼊：修复⽇期显示错误
输出：fix(reports): correct date formatting in timezone conversion
Use UTC timestamps in report generation
⼯作流模式——拆成步骤 + 清单：
## 表单填写流程
- [ ] 步骤 1：分析表单结构
- [ ] 步骤 2：建⽴字段映射
- [ ] 步骤 3：校验映射
- [ ] 步骤 4：填充表单
- [ ] 步骤 5：检查输出
⼯具脚本——复杂或易错步骤⽤现成脚本，减少⽣成代码、保证⼀致：
## 脚本
**analyze_form.py**：从 PDF 提取表单字段
\`\`\`bash
python scripts/analyze_form.py input.pdf > fields.json
\`\`\`
**validate.py**：校验结果
\`\`\`bash
python scripts/validate.py fields.json
# 输出：OK 或错误列表
\`\`\`
明确写清：Agent 是执⾏脚本，还是仅参考脚本逻辑。
如何写一个skill，一是在cursor里通过/create-skill以及文字描述写skill，二是在D:\cursor-game-1\.cursor\skills目录下粘贴skill-creator目录(cursor里无法粘贴，只能通过该方法，尽量用这个方法)，如下图：
可以用这个SKILL.md文件，也可以通过/skill-creator来创建skill。参考的网址如下：
https://github.com/anthropics/skills/tree/main/skills/skill-creator
https://github.com/anthropics/skills/tree/main
13. Cursor MCP 介绍
13.1 什么是 MCP
MCP(Model Context Protocol)是由 Anthropic 提出的开放协议，让 AI 模型(如 Claude、Cursor、Codex)能与外部⼯具和服务交互。通过 MCP，Cursor的Agent可以：
访问数据库(查询、结构探查)
调⽤外部 API
读写⽂件系统、执⾏系统命令
使⽤浏览器⾃动化(导航、截图、填表)
连接⾃定义服务(如内部接⼝、爬⾍)
从⽽突破「只能看代码、改代码」的限制，在 Composer / Agent 模式下⾃动选⽤这些能⼒完成⽤户请求。
D盘下新建一个文件夹，api-test-1，然后在cursor里打开文件夹api-test-1，快捷键打开 Cursor 设置面板：Ctrl+Shift+J，点击Customize，点击MCPs，如下图：
点击New，弹出New，弹出如下图：
点击User，跳转到mcp.json，文件里为空，因为没有安装Git，所以无法下载插件。点击Browse Marketplace按钮，再点击Cursor Marketplace，在搜索框里输入playwright，搜索成功，点击Add按钮，在搜索context7，也搜索成功。点击New MCP Server，再点击User，这下mcp.json里有内容了，如下图：
13.2 配置⽅式概览
MCP 有三种常⻅配置⽅式：
版本与模式：Cursor 0.45.6 及以上⽀持 MCP；MCP ⼯具仅在 Composer / Agent 模式下可⽤，普通聊天不会调⽤。
13.3 配置⽂件位置与结构
配置⽂件位置：
全局的就是C:\Users\nantian\.cursor\mcp.json，项⽬级配置会覆盖或与全局配置合并(视 Cursor 版本⽽定)，适合按项⽬启⽤不同 MCP。
常⽤字段说明：
13.4 传输类型
⼤多数官⽅/社区 MCP Server 以 stdio ⽅式运⾏，⽤ npx -y @modelcontextprotocol/server-xxx 即可。
13.5 常⽤ MCP 服务器推荐
以下为常⽤ MCP 服务器推荐，配置时写⼊ .cursor/mcp.json 或 ~/.cursor/mcp.json 的mcpServers 对象（若使⽤数组形式则放⼊ servers 数组）。具体包名与参数以各项⽬官⽅⽂档为准。
在cursor chat输入使用playwright mcp，打开浏览器使用百度查询一下今天北京的天气，打开浏览器，展示北京的天气，mcp比较浪费token，现在都封装成cli命令行的模式。
13.6 在 Cursor 设置中配置 MCP(界⾯⽅式)
1. 打开 Cursor 设置： Cmd/Ctrl + ,
2. 左侧找到 Customize，点击 MCPs
3. 点击 "+ Add New MCP Server" 或 "Edit in settings"
4. 在打开的 JSON 中按上⾯结构添加或修改 Server
5. 保存后重启或重新加载 Cursor，使 MCP ⽣效
部分内置或已安装的 Server 可直接在列表中勾选启⽤，⽆需⼿写 JSON。
https://www.deepseek.com/harness/ DeepSeek Harness 开发者预览版 一键使用：npx @deepseek-ai/dsh web，运行如下：
打开这个链接，跳转到如下页面：
需要生成并使用API-Key才能继续操作，https://platform.deepseek.com/，使用该链接通过手机号、验证码方式完成实名认证，进入页面后点击左侧API keys，点击创建API key按钮，跳转页面随便输入一个名称，点击创建，生成API key：sk-5dfed4eea0834bb99aac71b87e98a4e8。输入API key，点击保存并继续，进入deepseek HARNESS页面，创建一个文件夹，如dsh-demo，切换空间到这个目录，必须要有这个工作区，要不然不能用，在对话框里输入帮我安装这个插件Small-tailqwq / dsh-deep-whale，运行，提示Insufficient Balance，没有充值所以对话无法继续，同时能看到如下图：
每次的对话都能展示在轨迹里，还能下载log，如果有余额的话能看到一个漂亮的皮肤(重启即可)，然后再卸载就可以了(帮我把刚才的皮肤插件卸载掉)，可以开发插件，打上dsh-plugin标记就能识别出来deepseek harness插件。
画图软件archify：cmd里执行命令npx skills add tt-a1i/archify -g，出现如下图：
画图软件安装失败了，应该是没有安装VPN，如果安装成功了，可以在cursor里问你现在有哪些关于archify的skill，如下图：
目前这个画图软件是最好的。
在deepseek里输入next-ai-draw-io github地址，搜索出地址后，在cursor里输入你阅读realworld-django-ninja找个后端代码仓库，帮我画出架构图，会生成一个html文件，一张漂亮的架构图出来了。
,
"drawio": {
"command": "npx",
"args": ["@next-ai-drawio/mcp-server@latest"]
}
上述内容添加到mcp.json里
ClaudeCode、Codex、Cursor的区别：
相同的模型在不同的harness下跑出来的结果也不同
claudecode的harness比其他的都强，mcp、skill是claudecode提出来的
claudecode不好的地方是命令行的、没有ide，Claudecode5小时限制，用完了在等5小时
cursor有保存(keep)和撤销(undo)的操作，claudecode没有
codex没有command命令，codex去咸鱼或淘宝上买售后的，codex一周限制，用完了在等一周，codex经常重置，如周日到下周日，周中就重置了，token满格
dashi-taskboard在GitHub上的主要仓库地址是：https://github.com/chuspeeism/dashi-taskboard，这是一个本地优先的任务面板，运行在浏览器中，可以嵌入到codex中使用。codex国内需要**。
CC Switch：https://ccswitch.io/zh/ 统一管理你的 AI 编程工具工作流
ego (lite) 是一款为以下用户打造的浏览器共享您登录的浏览器状态与您的 AI Agent（例如 Codex 或 Claude Code ）一起使用，而不会打扰您。零费用，零配置。让他们更快地处理浏览器自动化任务。目前只有mac版本的，Windows还没有，安装成功后，在cursor里能调出/ego-browser，查找速度比较快。ui测试(不是自动化)可以考虑ego，根据页面定位，速度快
浙公网安备 33010602011771号