Impeccable for Cursor¶

使用 Impeccable 设计和优化界面：一项技能、专家智能体，以及编辑前的设计检查。调用 /impeccable polish、/impeccable audit，或描述你想要的设计工作。

安装¶

这个原生 Cursor 插件正在准备接受市场审核；它还没有成为已发布的列表项。对于现有项目的安装，请运行：

npx impeccable install --providers=cursor --scope=project

请选择该安装或插件中的一种，不要同时使用，以避免技能和钩子重复。插件不会将文件复制到项目的 .cursor 目录。其启动器会在首次使用时下载固定版本的 Impeccable 引擎（如果尚未缓存）；插件本身不需要 Node 运行时。智能体和 shell 权限仍由 Cursor 控制。可选的图像生成功能需要自己的提供方凭据和批准。

本地插件预览¶

在 Impeccable 仓库中，运行 bun run build，然后将 dist/cursor-plugin 复制到 ~/.cursor/plugins/local/impeccable。不要覆盖现有的安装。Cursor 3.15.6 会拒绝目标指向其本地插件目录之外的符号链接，因此请使用真实的复制副本。重新加载 Cursor，然后在 Customize 中检查技能和四个智能体，并在 Hooks 中检查 preToolUse 的执行。从市场安装的同名插件会优先于本地预览。本地插件是用户级的，即使使用单独的编辑器配置文件进行测试也是如此；完成后请移除临时副本。

使用插件目录之外的合成项目来测试上下文解析。文档中的 workspaceOpen/pluginPaths 替代方案在 3.15.6 冒烟测试中未能可靠执行；它并不是经过验证的预览路径。

预编辑钩子使用 Cursor 现有的 POSIX 启动器集成。Windows shell 行为和远程环境需要单独验证，才能宣称支持该插件的钩子。

验证状态¶

自动化检查涵盖真实的 Cursor-provider 打包、参考链接、四个智能体文件、可执行权限、版本漂移，以及将钩子移入包含空格的路径。直接调用分阶段启动器可以从单独的合成项目正确加载上下文。完整的非计费回归测试和 source-first/release 构建均已通过。

在 macOS 上使用 Cursor 3.15.6 时，本地插件加载时解析器零失败，并暴露了一个技能和四个智能体。一个真实的 /impeccable 请求对合成项目运行了一次已安装的启动器，并读取了已安装的 polish 参考，没有编辑项目文件。原生 preToolUse 日志确认了从已安装插件中执行并返回有效响应。与单独的用户技能同时安装会产生重复的斜杠菜单条目；请选择一种安装方法。

一次原生的 impeccable-asset-producer 交接解析了所提供的技能脚本路径，并确认启动器存在，但没有生成资产。另一次单属性 fixture 编辑在 Cursor 原生的 Write 工具上触发了 preToolUse：已安装的钩子以 0 退出并返回了有效的 JSON。之后恢复了 fixture，并移除了临时本地插件。Windows 和远程运行时检查仍未完成。

维护者提交清单¶

• 公共仓库：https://github.com/pbakaus/impeccable
• 市场清单：.cursor-plugin/marketplace.json；插件源码：cursor-plugin/。
• 原生清单、技能、智能体、钩子、徽标和许可证由 bun run build:release 从源码生成，并由 generated-output 工作流保持最新。不要手动编辑 cursor-plugin/。
• 验证 /impeccable 的发现、已安装路径下的上下文调用、智能体的发现和交接路径，以及 Cursor 中真实的预编辑钩子事件。
• 在合并并验证之后，将仓库提交到 https://cursor.com/marketplace/publish。提交和发布需要维护者批准。只有在获得接受后，才能替换本准备通知并添加实际的列表链接。

参考资料：Cursor 插件、插件参考、钩子。