Cursor Skills 是按需加载的工作流程说明。它们可以来自项目、个人目录或插件；看到名称不代表执行成功，还要确认触发范围和实际输出。
开始前先准备什么
先打开 Customize → Skills，检查技能名称、描述、来源和适用路径，确认它属于当前项目。
还要先分清 Skill 的来源。项目 Skill 常见于 .cursor/skills/ 或 .agents/skills/，会随仓库版本维护；个人 Skill 位于 ~/.cursor/skills/ 或 ~/.agents/skills/，通常只影响本机；插件也可以带入 Skill。目录不同意味着维护者、可见范围和更新方式不同，不能把同名 Skill 当成同一份内容。
第一次调用前先保存 git status --short，并选择一个低风险任务。若 Skill 会运行脚本、访问网络、写文件或调用外部服务，应先读清参数和权限，使用测试数据，而不是直接操作生产环境。
实际操作步骤
- 审查说明：阅读 SKILL.md 的输入、步骤、允许工具和完成条件，避免只凭技能名称判断。description 决定它什么时候相关，paths 会限制它只在匹配文件上出现；设置了禁止模型自动调用的 Skill 只能手动触发。
- 显式调用：在聊天输入框键入
/并选择目标 Skill，再附上一个明确任务。官方文档说明，这种调用只附着到当前消息；需要在整个会话持续使用时，可把 Skill 设为 Custom Mode。 - 观察过程：检查 Agent 是否读取了 Skill 要求的文件、运行了约定命令，并按规定格式输出。脚本成功启动不等于任务成功，还要看退出码、生成文件和业务验收。
- 核对副作用：比较调用前后的 Git 状态和文件清单，确认没有修改范围外内容。
- 测试边界：用一个反例任务测试边界：不符合 paths 或触发描述时，技能不应被错误套用。若是手动调用型 Skill，则应确认未点名时不会自动加入。
一个低风险调用示例
假设项目里有 /review-change，可复制下面的输入。名称和命令只是演示，使用前要换成 Customize 页面实际显示的 Skill：
/review-change
只审查当前未提交 diff，不要修改文件。请按该 Skill 的步骤执行，列出：
1. 实际读取的文件；
2. 实际运行的只读命令；
3. 按严重程度排序的问题和定位；
4. 无法验证的部分。
如果 Skill 要求写文件或访问外部服务，先停下说明原因。预期结果不是一段泛泛建议，而是能和 SKILL.md 对上的步骤、文件与检查结论。若 Agent 没有说明使用了哪个 Skill，或跳过其明确要求的验证，应视为未完成并重新缩小任务。
怎样验证结果
验证结果应包含技能来源、实际执行步骤、生成文件或检查结果，并能和 SKILL.md 对照。
最好保留一张四列记录：Skill 名称与来源、输入、实际动作、验收结果。调用前后分别运行一次 git status --short；有生成物时逐个打开检查，不能只看到文件存在。若 Skill 声称执行了测试，核对真实命令、退出码和失败数量。
常见错误
- 不要把技能输出当作测试结果。
- 不要安装来源不明且要求敏感权限的技能。
- 技能与项目规则冲突时先解决规则。
适用边界
第三方 Skill 可能包含脚本或外部服务调用，使用前要像审查代码一样阅读。
个人 Skill 不会自动出现在所有远程环境。官方说明，~/.cursor/skills/ 需要开启 Sync Skills for Cloud Agents 才能给 Cloud Agents 使用；~/.agents/skills/ 和未同步内容不会因此复制过去。团队分享则是另一条发布流程，不能把个人同步理解为团队已安装。
相关问答
Skills 会一直占用上下文吗？
官方设计是按需发现和加载；仍应保持描述准确、正文聚焦。
个人 Skill 能在云 Agent 使用吗？
需要按官方说明启用同步，且云环境仍要具备相关依赖。
资料与适用范围
本文根据 2026 年 10 月 1 日核验的 官方资料 1、官方资料 2 整理。示例流程未在你的设备、账号或仓库中实测，界面、方案、权限和项目命令应以当前环境为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32607.html
