进阶 impeccable.style 2026-11-22 15:26:07 · 2 阅读

第3章 代理缺失的设计词汇

常见问题 快速上手,保持 Impeccable 更新,并在遇到故障时找到解决方案。

大多数代理使用 /impeccable。在 Codex 中,请使用 $impeccable。

我是 AI 编码工具新手,该从哪里入手? 在受支持的编码工具中打开你的项目,然后按照“快速入门”指南操作。该流程将引导你完成安装并配置项目上下文,随后你可以选择构建新功能或优化现有页面。你无需具备设计经验或熟悉专业设计术语,只需描述你要制作的内容、目标受众以及目前的问题所在即可。例如,在你的代理聊天框中输入:

/impeccable 这个仪表盘上的关键信息被淹没了。请帮我让它更清晰。

如果你是该编码工具本身的新手,请先参考其关于“打开项目”和“与代理对话”的指南。你完全可以一边使用一边熟悉 Impeccable。

如何安装 Impeccable,或使用下载的文件? 在终端中打开项目文件夹并运行: npx impeccable install 选择你的编码工具,并确定是仅对当前项目还是所有项目进行安装。安装程序会自动选择匹配的构建版本。这需要 Node.js 18.19 或更高版本。安装完成后,请重新加载你的编码工具。

下载了 ZIP 包?请将其内容(包括隐藏文件夹)复制到项目根目录,与 package.json 或 src/ 并列放置,不要放入额外的外层文件夹中。压缩包内的 README.txt 会指明各工具对应的文件夹。

例如,一个 Codex 项目的安装结构如下: your-project/ ├── .agents/ │ └── skills/ │ └── impeccable/ │ └── SKILL.md ├── package.json └── src/ 在 macOS 上,可在 Finder 中按下 Command–Shift–. 以显示隐藏文件夹。其他安装方法请参阅“安装 Impeccable”。

如何更新 Impeccable? 如果使用 Impeccable 安装程序完成安装,请在终端中运行: npx impeccable update 请在项目文件夹内运行此命令。如果你同时拥有项目级和用户级安装,请选择要更新哪一个。你可以直接指定 --project 或 --user 参数。若要先检查是否有更新,可运行 npx impeccable check。更新操作会替换 Impeccable 的安装文件,但不会修改项目中的 PRODUCT.md 和 DESIGN.md。

通过其他方式安装的?请通过原路径更新: 市场或插件:使用编码工具的插件管理器。 npx skills:再次运行 npx skills add pbakaus/impeccable。这会安装共享构建版本;而 Impeccable 安装程序会为特定工具选择相应的构建版本。 ZIP:从主页下载最新压缩包,替换已安装的 Impeccable 文件。 更新后请重新加载编码工具。仅当你打算替换现有安装时,才使用 npx impeccable install --force。

Impeccable 未出现或无响应,该怎么办? 检查安装配置:确认你选择了正在使用的编码工具。项目级安装必须位于你当前打开的项目中。如果使用的是 ZIP 复制安装,请同时检查隐藏文件夹。 重新加载工具:新安装的技能可能需要重新加载或开启新会话才能显示。 直接调用 Impeccable:在代理聊天中尝试: /impeccable 设计指令属于此主技能的一部分。你无需为 audit(审计)、polish(润色)或 critique(批评)单独安装。 使用命令框切换器以适配 Codex 语法:在 Codex CLI 或 IDE 扩展中,你可以通过打开 /skills 或输入 $ 来查找已安装的技能。请参阅“Codex 技能指南”。 仍未找到?请检查工具的“技能设置”和“发现列表”: Cursor:在已发现技能中寻找 Impeccable。参考“Cursor 技能”。 Devin:运行 devin skills list 或 devin skills paths 以查看其搜索路径。参考“Devin 技能”。 Gemini CLI:运行 /skills list;修改安装配置后使用 /skills reload。参考“Gemini 技能管理”。 GitHub Copilot:确认你当前使用的环境中是否可用代理技能。参考“Copilot 代理技能”。 Replit Agent:Impeccable 安装在 .agents/skills/ 文件夹中,这是 Replit 读取的位置。在文件侧边栏中开启“显示隐藏文件”以查看。参考“Replit Agent 技能”。 如果 Impeccable 可用但自动检查功能无响应,请遵循“Hook 设置指南”。“技能发现”和“执行 Hook 的权限”是两项独立的检查。

能否为我常用的命令创建快捷方式? 可以从代理聊天中固定: /impeccable pin critique 这会在你的编码工具中为 critique 创建快捷方式。它会向 Impeccable 转发请求,因此主技能的改进也会体现在快捷方式中。你还可以固定 polish、audit 和 live 等命令。 若要移除快捷方式: /impeccable unpin critique 移除快捷方式后,主命令依然可用。请在编码工具的“技能”或“命令”列表中查看对应的快捷方式名称。

何时该用 generate 而不是 live? 当你能明确指出目标元素和希望探索的方向时,请使用 generate。在代理聊天中运行: /impeccable generate 3 bold variants of the pricing cards 代理会找到该元素,并在你正在运行的页面上展示变体。你可以对比效果,如有控制器则进行微调,最后选择接受某个版本到源码中,或放弃这一组变体。 对于持续性的浏览器会话,如果你希望自行选取元素、添加批注,或使用 Steer 发起全页请求,请使用 live。两个命令均适用于 Web 项目,除非你要求变更,否则它们会遵循现有的设计身份。

Impeccable 收费吗? 免费。Impeccable 的公共技能、命令、CLI 及检测引擎均在 Apache 2.0 许可证下开源免费。你的编码工具或模型提供商可能会收取使用费用(包括图像生成费用),这些成本与 Impeccable 无关。关于内置支持、OpenAI API 回退机制及计费指南,请参阅“启用图像生成”。

评论 (0)