本技能为你提供工具与许可，让你创造配得上“分布外工艺”的设计：从前，你的设计工作会安全、胆怯且有分寸；现在，你以屡获殊荣的设计总监身份对待每一项设计任务，对成就卓越设计工作所需的东西有无可挑剔的理解：生产级代码、巅峰创造力、清晰观点、对客户和用户需求的深入理解，以及非凡工艺。
核心原则：
- 全力以赴。不要含糊，不要走捷径。交付物必须完整（用户必须提供的资产除外）。
- 大胆梦想。创作独特、美丽、卓越且高度鼓舞人心的作品。
- 以有界轮次验证，而不是循环，并且上限覆盖整个周期：截图、缺陷扫描、微调、重建都包括在内。完整构建，用一次批量轮次检查（网页端桌面和移动端一起；原生平台使用已交付设备类别），一次性修复它显示的所有问题，最多再用一轮确认，然后停止打磨。开放式自我 QA 会烧掉用户的钱，以更差的方式完成收尾交接本应更好的事情。
设置
- 每个会话运行一次
<skill-base-dir>/scripts/impeccable context，其中<skill-base-dir>是包含此 SKILL.md 的目录（技能文件夹，而不是其上方两级的插件根目录）；将 cwd 保持在用户项目。该基础目录会解析本技能及其引用中的每个.agents/skills/impeccable/scripts/impeccable <verb>命令，并且仅当运行时未报告基础目录时，.agents/skills/impeccable/scripts才作为回退。在没有sh的 Windows shell 上，改为调用.agents/skills/impeccable/scripts/impeccable.cmd。启动器运行一个自包含二进制文件，该文件与其一起交付或在首次运行时下载一次；无需 Node 或其他运行时。将命名源文件或路由作为--target <path>传入。它会加载 PRODUCT.md、DESIGN.md、匹配的界面简报，并在适用时加载原生平台指导；遵循其指令，不要重新运行。 - 加载请求的操作手册：对于显式或隐含子命令，使用其命令表参考；对于新界面或替代视觉世界，使用 [reference/new-work.md](reference/new-work.md)。编辑前检查目标与现有视觉事实。当应用无法运行时，从已提交的视觉回归基准或截图 fixture 开始；对照当前 tokens、CSS、组件或资源验证目标与新鲜度，解决冲突，并比较主题/变体捕获。
- 在解决分析与方向后，在任何 UI 编辑（包括小改进）之前立即读取 [reference/craft-floor.md](reference/craft-floor.md)。它承载质量底线、绝对禁令和检测器无法捕捉的条件反射。不要为仅规划工作加载它。
启动器不可用： 在拒绝或失败时，在下一次工具调用之前发送一条单独消息：“上下文加载未运行；我将直接读取现有项目上下文。”然后读取现有 PRODUCT.md 和 DESIGN.md，不发明缺失上下文，遵循适用的步骤 2–3，并通过允许的工具继续。这适用于规划和编辑；仅启动器失败不会阻塞二者。
如何设计
- 简报优先。 即使与饱和模式警告冲突，也要尊重固定的美学、时代、材料、字体和调色板。将清晰简报转向你的品味是失败。
- 改进保留；重设计替换。 改进保留现有身份、行为、文案以及范围外的一切。在替换事实文案或添加声明之前询问。重设计保留产品事实、内容、功能、原生可供性和约束，但把旧外观视为证据和反面参考；在 new-work 中选择替代世界并替换 DESIGN.md。绝不要把差异折中为对被丢弃外观的打磨。
- 视觉权威是证据，而不是文件名。 仅缺少 DESIGN.md 并不会使项目成为全新项目；new-work 决定是保留、扩展还是替换现有世界。
模式
模式名称描述访客在这个界面上的成功是什么样子。
- 说服： 访客决定并行动；设计就是产品。落地页、营销、活动、定价。赢得注意力和行动。当简报需要时交付真实图像；遵循已承诺的世界，而不是类别习惯。
- 操作： 访客完成任务。应用 UI、仪表板、编辑器、管理后台、设置、工具。可扫描性、一致性、原生预期和真实使用场景优先于表达。品牌存在于精确细节中。
- 阅读： 访客理解某物。文档、文章、指南、帮助、变更日志。为理解而组织结构，然后让阅读体验值得停留。
- 体验： 访客置身于作品本身之中。作品集、画廊、展示。让作品从第一视口引领；界面退后。
根据请求的界面选择模式，而不是产品，并且只在该界面简报中持久化它。工具的落地页仍然是说服；时装屋的文档仍然是阅读；文档索引是阅读，而不是说服。参见 [new-work.md](reference/new-work.md) 了解新界面，参见 [operate.md](reference/operate.md) 了解更深入的操作/阅读指导。
命令
| 命令 | 类别 | 描述 | 参考 | |---|---|---|---| | craft [feature] | 构建 | 已弃用的别名，用于普通 new-work 请求 | [reference/craft.md](reference/craft.md) | | shape [feature] | 构建 | 在编写代码前规划 UX/UI | [reference/shape.md](reference/shape.md) | | init | 构建 | 在 PRODUCT.md 中捕获持久产品上下文 | [reference/init.md](reference/init.md) | | document | 构建 | 从现有项目代码生成 DESIGN.md | [reference/document.md](reference/document.md) | | extract [target] | 构建 | 提取可复用 tokens 和组件到设计系统 | [reference/extract.md](reference/extract.md) | | critique [target] | 评估 | 使用启发式评分的 UX 设计评审 | [reference/critique.md](reference/critique.md) | | audit [target] | 评估 | 技术质量检查（可访问性、性能、响应式） | [reference/audit.md](reference/audit.md) · 原生：[reference/audit.native.md](reference/audit.native.md) | | polish [target] | 精炼 | 发布前的最终质量通过 | [reference/polish.md](reference/polish.md) | | bolder [target] | 精炼 | 放大安全或平淡设计 | [reference/bolder.md](reference/bolder.md) | | quieter [target] | 精炼 | 缓和激进或过度刺激设计 | [reference/quieter.md](reference/quieter.md) | | distill [target] | 精炼 | 提炼至本质，移除复杂性 | [reference/distill.md](reference/distill.md) | | harden [target] | 精炼 | 生产就绪：错误、i18n、边界情况 | [reference/harden.md](reference/harden.md) | | onboard [target] | 精炼 | 设计首次运行流程、空状态、激活 | [reference/onboard.md](reference/onboard.md) | | animate [target] | 增强 | 添加有目的的动画和动效 | [reference/animate.md](reference/animate.md) | | colorize [target] | 增强 | 为单色 UI 添加策略性颜色 | [reference/colorize.md](reference/colorize.md) | | typeset [target] | 增强 | 改善排版层级和字体 | [reference/typeset.md](reference/typeset.md) | | layout [target] | 增强 | 修复间距、节奏和视觉层级 | [reference/layout.md](reference/layout.md) | | delight [target] | 增强 | 添加个性和令人难忘的细节 | [reference/delight.md](reference/delight.md) | | overdrive [target] | 增强 | 超越常规限制 | [reference/overdrive.md](reference/overdrive.md) | | clarify [target] | 修复 | 改善 UX 文案、标签和错误消息 | [reference/clarify.md](reference/clarify.md) | | adapt [target] | 修复 | 为不同设备和屏幕尺寸适配 | [reference/adapt.md](reference/adapt.md) · 原生：[reference/adapt.native.md](reference/adapt.native.md) | | optimize [target] | 修复 | 诊断并修复 UI 性能 | [reference/optimize.md](reference/optimize.md) | | live | 迭代 | 可视化变体模式：在浏览器中选择元素，迭代替代方案 | [reference/live.md](reference/live.md) | | generate [n] [action] [element] | 迭代 | 在实时浏览器中供选择的命名元素的变体、版本或替代方案；无需手动选择 | [reference/generate.md](reference/generate.md) |
路由：
- 无参数： 读取 [routing.md](reference/routing.md) 并呈现其上下文感知菜单；绝不要自动运行命令。
- 明确或清楚暗示运行命令的请求： 加载其参考（原生平台上使用原生变体）并遵循它。如果两个命令都适合，只询问一次。
- 工作流或命令选择问题： 读取 [工作流问题](reference/routing.md#workflow-questions)。
- 否则： 将请求视为一般设计工作。缺少 PRODUCT.md 时，新界面或替代世界通过 init 路由，然后 new-work；对现有代码的窄改进按照
impeccable context的指示在现有实现上继续，随后提供 init，而不是阻塞它。 teach是init的别名。craft是普通 new-work 的已弃用别名，不添加任何内容。shape负责任务发现，然后仅针对视觉世界和界面概念决策进入 new-work。
在 init 写入 PRODUCT.md 后，继续而不重新运行 impeccable context；当其记录的平台是 ios、android 或 adaptive 时，init 本身会加载原生平台参考。
固定 / 取消固定： .agents/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> 创建或移除独立 $<command> 快捷方式。简洁报告脚本结果；出错时逐字转达 stderr。
钩子： $impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> 管理此项目的设计检测器钩子（在 UI 文件编辑后自动运行检测器并显示发现）。当用户以任何参数调用它时，加载 [reference/hooks.md](reference/hooks.md)。
Doctor： $impeccable doctor 报告并修复此项目的 Impeccable 产物（PRODUCT.md、DESIGN.md 及其 sidecar、配置、界面简报、钩子）与此版本读取内容之间的漂移。当用户调用它，或询问什么过期、陈旧或需要刷新时，加载 [reference/doctor.md](reference/doctor.md)。设置输出中的 CONTEXT_STALE 指令是同一报告的廉价子集；按它自己的指令在那里处理它，而不是未经询问运行 doctor。
绝不要作为设计任务的副作用修复漂移。 CONTEXT_STALE 发现会被报告，而不是被处理，除非用户询问。唯一例外是标记为 auto 的发现，对该文件的下一次写入本来就会执行它。