用途:从零创建新的 Cursor 插件,使其可直接本地使用或提交到市场。
必要输入:插件名称(小写 kebab-case)、插件用途与目标用户、要包含的组件集合(rules、skills、agents、commands、hooks、mcpServers)、仓库风格(单插件或多插件市场)。
输出位置:默认创建在用户本地插件目录 ~/.cursor/plugins/local/<plugin-name>/,该路径使插件无需安装步骤即可被 Cursor 使用;若用户明确指定其他路径(如已有仓库或特定目录),则遵循该选择。
工作流程:校验插件名称格式(小写 kebab-case,以字母数字开头和结尾);确定目标目录(默认或用户指定);目录不存在时创建(含父目录);在目标目录内创建基础文件 .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 等元数据);确保所有清单路径为相对路径、有效,不使用绝对路径或父级遍历。
限制与护栏:插件应聚焦单一用例;优先使用简洁可执行的技能与规则文本而非长篇叙述;不要引用不存在的文件;除非需要自定义路径,否则使用文件夹发现默认值;除非用户提供不同路径,否则始终保存到 ~/.cursor/plugins/local/<plugin-name>/。
输出:插件的已创建文件树(含输出目录完整路径)、最终 plugin.json、市场条目(如适用)、必填字段与组件元数据的简短校验报告,以及插件已保存到 ~/.cursor/plugins/local/ 并可供使用的确认。