一、常见误解很多人第一次接触 Skills以为它只是“给 Cursor 写规则文档”。这个理解太窄了。Skills 的本质是可复用的能力模块。它不只是“规定输出格式”而是可以封装任意需要多步操作、特定上下文或外部工具配合的任务。二、三种类型类型核心作用典型场景约束型规定格式和边界commit 规范、代码注释风格流程型固定多步操作PR 审查流程、部署前置检查工具型集成外部能力调用 API、执行脚本、解析日志实际使用中一个 Skill 往往是三种类型的混合体。比如 PR 审查 Skill既约束标题格式约束型又执行拉 diff→检查→报告流程型还可能调用 Jira API 查单号状态工具型。三、存放位置全局 Skills~/.cursor/skills/作用于所有仓库。适合 commit 规范、通用注释风格。项目 Skills项目根/.cursor/skills/仅作用于当前仓库。适合业务命名规则、内部系统集成。优先级项目 Skills 覆盖全局 Skills。四、触发机制自动触发在 Skill 文件的description中描述使用场景。Cursor 根据用户当前操作自动判断加载。示例description:Use when writing or reviewing commit messages,git log,or changelog entries手动调用对话中输入“使用 xxx Skill 帮我……”或通过 Command Palette 选择。五、完整流程匹配不匹配约束型流程型工具型用户执行操作Cursor 匹配描述加载 Skill默认行为识别类型按规则输出执行步骤序列调用外部能力返回结果六、实战案例案例一commit 规范约束型配置前Cursor 输出update code、fix bug等无效信息。配置git-conventional-commitsSkill 后输出feat(cloud): 支持项目资源增量同步 fix(login): 修复 token 过期后未刷新案例二PR 自动审查流程型一个 PR 审查 Skill 封装以下步骤拉取当前 PR 的 diff扫描调试代码console.log、print、debugger验证 commit 类型是否符合规范输出结构化报告用户只需说“审查这个 PR”四步自动完成。案例三日志分析工具型一个日志分析 Skill 可以读取.log文件按正则提取错误堆栈调用grep/jq过滤输出分类汇总和频率统计用户不再需要手动组合 shell 命令。七、修复类提交演示渲染错误:Mermaid 渲染失败: Parse error on line 3: ...B -- C[生成标题fix(auth): token过期未刷新] -----------------------^ Expecting SQE, DOUBLECIRCLEEND, PE, -), STADIUMEND, SUBROUTINEEND, PIPE, CYLINDEREND, DIAMOND_STOP, TAGEND, TRAPEND, INVTRAPEND, UNICODE_TEXT, TEXT, TAGSTART, got PS实际输出fix(auth): token过期后未刷新 原因session超时未触发刷新逻辑 方案拦截器增加401处理 影响仅影响jwt过期场景八、关键提醒description 决定触发率写“use when writing commit”比写“commit helper”准确得多非强制执行Cursor 尽量遵守 Skill但关键规则仍需 CI/hook 兜底混合使用不要被三种类型限制一个 Skill 可以同时包含约束、流程和工具调用九、起步建议从约束型开始放一个 commit 规范到全局 Skills使用一周观察触发效果调整 description按需增加流程步骤如自动检查需要外部能力时再集成工具调用一个 Skill 配置正确后用户不再需要每次重复解释规则也不需要手动执行多步操作。这是 AI 辅助编码从“对话”走向“自动化”的关键一步。