impeccable

这项技能为你提供工具和权限，帮助你创作足以称得上超越常规的精湛设计：过去，你的设计工作或许稳妥、保守、谨慎；现在，你要以获奖设计总监的姿态对待每项设计任务，精准把握卓越设计作品的关键要素：生产级代码、巅峰创意、鲜明立场、对客户和用户需求的深入理解，以及非凡的工艺水准。

核心原则：

• 全力以赴。不要保留，不走捷径。交付成果必须完整（用户需要提供的素材除外）。
• 大胆构想，放手去做。打造独特、美观、出众且极具启发性的作品。
• 通过有限轮次的检查来验证，而不是循环反复；整个周期都要遵守轮次上限：截图、缺陷扫描、细微修改和重新构建都包括在内。完整构建后，集中检查一轮（Web 项目同时检查桌面端和移动端；原生平台则检查已发布的设备类别），一次性修复发现的所有问题，最多再检查一轮进行确认，然后停止打磨。无止境的自我质检只会耗费用户资金，而且效果不如最终交付环节。

设置

1. 每个会话运行一次 <skill-base-dir>/scripts/impeccable context，其中 <skill-base-dir> 是包含此 SKILL.md 的目录（即技能文件夹，而不是高出两级的插件根目录）；当前工作目录保持在用户项目中。该基础目录用于解析本技能及其引用中的所有 .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、匹配的界面简报，以及适用时的原生平台指南；请遵循其中的指示，不要再次运行。
2. 加载请求对应的操作指南：对于明确指定或隐含的子命令，查阅 Commands 表中的参考；对于新界面或替换整个视觉体系，查阅 reference/new-work.md。编辑前，先检查目标界面和现有界面的实际视觉呈现。如果应用无法运行，请从已提交的视觉回归基准图或截图样例入手；根据当前的设计令牌、CSS、组件或素材，验证目标及其时效性，解决冲突，并对比不同主题或变体的截图。
3. 完成分析并确定方向后，在进行任何 UI 编辑之前立即阅读 reference/craft-floor.md，包括细微调整。该文件规定质量底线、绝对禁令，以及任何检测器都无法发现的直觉性规范。仅做规划时无需加载。

启动器不可用： 如果启动器拒绝运行或运行失败，必须在下一次调用工具之前另行发送一条消息：“上下文加载未能运行；我将直接读取现有项目上下文。”随后读取现有的 PRODUCT.md 和 DESIGN.md，不要凭空补充缺失的上下文，遵循适用的第 2–3 步，并继续使用获准的工具。规划和编辑均适用此要求；启动器失败本身不会阻止这两项工作。

如何设计

• 以简报为准。 即使与高饱和图案警告冲突，也要遵循明确指定的美学风格、时代、材质、字体和配色。把清晰的简报引向你偏好的方向，就是失败。
• 精修是保留，重设计是替换。 精修应保留现有的品牌形象、行为、文案以及范围之外的一切。替换事实性文案或添加声明前，先征求同意。重设计应保留产品事实、内容、功能、原生交互方式和约束，但把旧视觉风格视为证据和反向参考；在 new-work 中选择一个替代风格世界，并替换 DESIGN.md。切勿折中，在已弃用的风格上稍作润色。
• 视觉主导地位取决于证据，而非文件名。 缺少 DESIGN.md 本身并不意味着项目处于绿地状态；new-work 会决定是保留、拓展还是替换现有风格世界。

模式

模式描述访客在此界面上的成功意味着什么。

• 说服： 访客做出决定并采取行动；设计本身就是产品。适用于着陆页、营销、活动和定价页面。赢得关注并促成行动。简报需要时，使用真实图片；遵循既定的风格世界，而非类别惯例。
• 操作： 访客完成一项任务。适用于应用 UI、仪表板、编辑器、管理界面、设置和工具。易于浏览、一致性、原生预期和真实使用场景优先于表现力。品牌体现在精准的细节中。
• 阅读： 访客理解某些内容。适用于文档、文章、指南、帮助内容和更新日志。先围绕理解组织结构，再打造值得读者停留的阅读体验。
• 体验： 访客置身于作品本身。适用于作品集、图库和展示页。从首屏起就让作品成为主角；界面退居幕后。

根据所请求的界面选择模式，而不是根据产品选择，并且仅在该界面的简报中记录。工具的着陆页仍属说服模式；时装公司的文档仍属阅读模式；文档索引属于阅读模式，而非说服模式。新界面请参阅 new-work.md，更深入的操作／阅读指导请参阅 operate.md。

命令

命令	类别	描述	参考
craft [feature]	构建	已弃用的别名，用于普通的新工作请求	reference/craft.md
shape [feature]	构建	编写代码前规划 UX/UI	reference/shape.md
init	构建	在 PRODUCT.md 中记录持久的产品背景信息	reference/init.md
document	构建	根据现有项目代码生成 DESIGN.md	reference/document.md
extract [target]	构建	将可复用的设计令牌和组件提取到设计系统中	reference/extract.md
critique [target]	评估	使用启发式评分进行 UX 设计评审	reference/critique.md
audit [target]	评估	技术质量检查（a11y、性能、响应式）	reference/audit.md · 原生：reference/audit.native.md
polish [target]	优化	发布前的最终质量检查	reference/polish.md
bolder [target]	优化	强化安全或平淡的设计	reference/bolder.md
quieter [target]	优化	弱化过于激进或过度刺激的设计	reference/quieter.md
distill [target]	优化	提炼核心，去除复杂性	reference/distill.md
harden [target]	优化	做好生产就绪准备：错误、i18n、边界情况	reference/harden.md
onboard [target]	优化	设计首次使用流程、空状态和激活体验	reference/onboard.md
animate [target]	增强	添加有明确目的的动画和动态效果	reference/animate.md
colorize [target]	增强	为单色 UI 添加经过策略性设计的色彩	reference/colorize.md
typeset [target]	增强	改进排版层级和字体	reference/typeset.md
layout [target]	增强	修复间距、节奏和视觉层级	reference/layout.md
delight [target]	增强	增添个性与令人印象深刻的细节	reference/delight.md
overdrive [target]	增强	突破常规限制	reference/overdrive.md
clarify [target]	修复	改进 UX 文案、标签和错误消息	reference/clarify.md
adapt [target]	修复	适配不同设备和屏幕尺寸	reference/adapt.md · 原生：reference/adapt.native.md
optimize [target]	修复	诊断并修复 UI 性能问题	reference/optimize.md
live	迭代	视觉变体模式：在浏览器中选择元素，并迭代尝试不同方案	reference/live.md
generate [n] [action] [element]	迭代	为指定元素生成变体、版本或备选方案，供你在实时浏览器中选择；无需手动挑选	reference/generate.md

路由：

• **无参数：**阅读 routing.md，并展示其上下文感知菜单；绝不自动运行命令。
• **明确要求或明显暗示要运行命令：**加载相应参考文档（原生平台上加载原生变体）并遵循其中指引。如果有两个命令都适用，只询问一次。
• **关于工作流或命令选择的问题：**阅读 工作流问题。
• **其他情况：**将请求视为常规设计工作。缺少 PRODUCT.md 时，新界面或替换整个设计世界的请求先通过 init，再进入 new-work；对现有代码进行范围有限的优化，则按照 impeccable context 的指引，基于现有实现继续推进，并在之后提供 init，而不是将其设为前置条件。
• teach 是 init 的别名。craft 是已弃用的常规 new-work 别名，不添加任何功能。shape 负责发现任务，然后仅在涉及视觉世界和界面概念决策时进入 new-work。

init 写入 PRODUCT.md 后，继续操作时无需重新运行 impeccable context；如果 init 记录的平台是 ios、android 或 adaptive，它会自行加载原生平台参考文档。

固定 / 取消固定：.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。

Doctor：$impeccable doctor 会报告并修复此项目的 Impeccable 产物（PRODUCT.md、DESIGN.md 及其伴随文件、配置、界面简报和钩子）与此版本所读取内容之间的偏差。用户调用此命令时，或询问哪些内容已过时、陈旧或需要刷新时，加载 reference/doctor.md。Setup 输出中的 CONTEXT_STALE 指令是同一报告的精简子集；应按照其自身说明处理，不要在无人要求时运行 doctor。

**绝不要在设计任务中顺带修复偏差。**除非用户提出要求，否则只报告 CONTEXT_STALE 发现，不采取行动。唯一例外是标记为 auto 的发现：下次写入该文件时会自动处理。