其他
新建 Cursor 插件时生成含 manifest…
从零创建 Cursor 插件并使其可本地使用或提交到 marketplace 时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
新建 Cursor 插件时生成含 man特定
解决思路
- 确认并记录所需输入:插件名称(小写 kebab-case)、插件用途与目标用户、要包含的组件集合(`rules`、`skills`、`agents`、`commands`、`hooks`、`mcpServers`)、仓库风格(`single-plugin` 或 `multi-plugin marketplace`)。
- 校验插件名称格式:必须为小写 kebab-case,且以字母数字字符开头和结尾。
- 确定目标目录:默认 `~/.cursor/plugins/local/<plugin-name>/`,该路径使插件无需安装步骤即可被 Cursor 立即使用;如果用户明确要求创建在别处(如已有仓库或特定目录),则尊重并使用用户指定路径。
- 如果目标目录不存在,创建该目录及其父目录。
- 在目标目录内创建基础文件:`.cursor-plugin/plugin.json`、`README.md`、`LICENSE`,可选创建 `CHANGELOG.md`。
- 填充 `plugin.json`:必填 `name`;建议填写 `version`、`description`、`author`、`license`、`keywords`;仅当需要非默认发现机制时,显式添加组件路径。
- 创建具有有效 frontmatter 的组件文件:Rules 使用 `.mdc`,包含 `description`、`alwaysApply`,可选 `globs`;Skills 使用 `skills/<skill-name>/SKILL.md`,包含 `name`、`description`;Agents 使用 `agents/*.md`,包含 `name`、`description`;Commands 使用 `commands/*.(md|txt)`,包含 `name`、`description`。
- 如果仓库使用 `.cursor-plugin/marketplace.json`,向其中添加插件条目:`name`、`source`,以及可选元数据(`description`、`keywords`、`category`、`tags`)。
- 确保所有 manifest 路径均为相对路径、有效,且不使用绝对路径或父级目录回溯(`..`)。
- 保持插件聚焦于一个用例。
- 技能和规则文本优先使用简洁、可执行的内容,而不是长篇说明。
- 不要引用不存在的文件。
- 除非确实需要自定义路径,否则使用文件夹发现默认值。
- 除非用户提供不同路径,否则始终保存到 `~/.cursor/plugins/local/<plugin-name>/`。
- 输出已创建插件的文件树,并包含输出目录的完整路径。
- 输出最终 `plugin.json`。
- 如适用,输出 marketplace 条目。
- 输出必需字段和组件元数据的简短验证报告。
- 确认插件已保存在 `~/.cursor/plugins/local/` 下并可供使用。
适用边界 · 注意事项
- 不适用于创建非 Cursor 插件或不需要 Cursor 插件 manifest/组件发现机制的项目。
- 不适用于已有插件只做小修改、调试或重构,而不需要重新生成脚手架的情况。
- 不适用于无法使用或写入 `~/.cursor/plugins/local/` 且用户也未提供其他目标路径的环境。