.cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)
Cursor 品牌专题:.cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)。 锚点:Cursor。
ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。

**## .cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)**
Cursor 的 .cursor/skills/ 文件夹为 AI 编程工具订阅用户提供了可复用的指令模块。
如果你正在使用 Cursor Pro、Cursor Business 或 Cursor 订阅,这些 .cursor/skills/*/SKILL.md 文件就是团队或个人最常用的多步工作流注入方式。
谁适用:需要自定义 AI 助手执行部署、安全审核或 TDD 流程的工程师;
决策依据:本地 .cursor/skills/ 方式免费、无限使用,适合追求低成本或私有化部署的用户;若需官方市场流量或预置模板,再考虑插件市场或专业 MCP 工具。
核心概念与术语
- SKILL.md:定义任务的工作流 Markdown 文件,包含激活条件、步骤、约束。
- Skills 仓库:存放 SKILL.md 的 .cursor/skills/ 文件夹,可置于项目根目录或全局 ~/.cursor/skills/。
- Agent:Cursor 的 AI 编码助手,自动发现并加载相关 SKILL.md。
- 插件市场:独立插件商店,用于一键安装预制技能包(非文件系统)。
- Cursor Pro / Business:不同订阅档位支持的技能范围与同步机制略有差异。
决策表 / 对照表
| 选择方式 | 适用场景 | 成本 | 维护难度 | 推荐人群 |
|---|---|---|---|---|
| 本地 .cursor/skills/ | 私有团队规范、Git 托管 | 免费 | 低 | 个人开发者、团队内部使用 |
| 官方市场插件 | 需要预制专业技能包 | 订阅费用 | 中 | 追求开箱即用 |
| 第三方 MCP 工具 | 需要云托管技能、自动同步 | 额外费用 | 高 | 企业级或多人协作 |
实操清单:分步可核对
1. 打开 Cursor IDE,创建或进入项目根目录。
2. 在项目根目录下新建文件夹 .cursor/skills/(若已存在可跳过)。
3. 进入 .cursor/skills/,创建任意 SKILL.md 文件(如 deploy-to-staging.md)。
4. 在 SKILL.md 中写入 Markdown 内容:任务描述、激活条件(如 /deploy)、详细步骤、硬约束。
5. 重启 Cursor 或执行 /skill deploy-to-staging 命令,Agent 会自动发现并加载。
6. (可选)将仓库托管到 GitHub,Cursor 可通过 MCP 或 .cursor/skills/ 自动拉取最新版本。
7. 测试:新建聊天,输入技能名称,验证 Agent 是否按预期执行多步工作流。
常见坑与风险边界
- 文件夹位置不正确或命名错误,导致 Agent 无法发现。
- SKILL.md 格式不标准(缺少激活条件或步骤),导致加载失败。
- 全局技能与项目技能冲突,造成混淆。
- 使用第三方工具时,MCP 连接不稳定。
站内路径:相关工具与页面
- 查看 Cursor 订阅 详情:/channels
- Cursor Pro / Business 官方定价:/official-prices
- 对比 AI 编程工具:/compare
- 官方 API 与模型接入:/official-api
- 更多技能相关指南:/guides
## 风险与边界
本地 .cursor/skills/ 方式完全免费、无需支付订阅即可使用,但若项目规模较大或需多平台同步,建议结合 Cursor Business 档位(以官方/挂牌页当日数据为准)。
非法律意见声明:本文仅为技术操作指南,不构成任何法律或合同义务。
## 延伸阅读