SuperAPI AI 工具集

impeccable

设计与创作

查看项目

更新于 10-15 08:27

技能介绍

用途

impeccable 是一个设计方向的智能体技能,用于支持从设计构思到最终交付的完整界面设计工作。它把每个设计任务当作由获奖级设计总监来完成:要求产出达到生产级代码质量、具备明确的观点、理解客户与用户需求,并追求出色工艺。

主要能力

根据资料,该技能通过一组子命令(Commands)组织能力,分为若干类别:

  • 构建类:shape(写代码前规划 UX/UI)、init(在 PRODUCT.md 中记录持久产品上下文)、document(从现有项目代码生成 DESIGN.md)、extract(抽取可复用的 token 与组件进入设计系统)。craft 是普通 new-work 请求的已废弃别名。
  • 评估类:critique(启发式评分的 UX 设计评审)、audit(无障碍、性能、响应式等技术质量检查,原生平台有独立参考)。
  • 精修类:polish(交付前的最终质量检查)、bolder(放大安全或平淡的设计)、quieter(收敛过于强烈或刺激的设计)、distill(去除复杂性,提炼本质)、harden(面向生产:错误、i18n、边界情况)、onboard(首次运行流程、空状态、激活)。
  • 增强类:animate(有目的性的动画与动效)、colorize(为单色界面添加策略性色彩)、typeset(改进字体层级与字体)、layout(修正间距、节奏与视觉层级)、delight(增加个性与记忆点)、overdrive(突破常规限制)。
  • 修复类:clarify(改进 UX 文案、标签与错误信息)、adapt(适配不同设备与屏幕尺寸,原生平台有独立参考)、optimize(诊断并修复 UI 性能)。
  • 迭代类:live(视觉变体模式:在浏览器中选择元素并生成替代方案)。

使用方式

  • 每个会话运行一次 node <skill-base-dir>/scripts/context.mjs,其中 <skill-base-dir> 是运行时报告的该技能已加载基础目录,并保持 cwd 位于用户项目。该基础目录解析本技能及其引用中的每个 node .agents/skills/impeccable/scripts/... 命令;仅当运行时不报告基础目录时,才以 .agents/skills/impeccable/scripts 作为回退。可通过 --target <path> 传入具名源文件或路由。
  • 路由规则:无参数时读取 routing.md 并展示上下文感知菜单,绝不自动运行命令;显式或明显隐含某命令时加载对应参考并遵循;否则视为通用设计工作。
  • 编辑 UI 前需先加载 reference/craft-floor.md(仅在纯规划工作时不必加载)。
  • Pin / Unpin:node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <command> 创建或移除独立的 $<command> 快捷方式。
  • Hooks:$impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> 管理本项目的设计检测钩子(在 UI 文件编辑后自动运行检测器并呈现发现)。
  • Doctor:$impeccable doctor 报告并修复本项目 Impeccable 产物(PRODUCT.md、DESIGN.md 及其 sidecar、配置、surface brief、钩子)与当前版本读取内容之间的漂移。

设计模式

按目标界面而非产品类型选择模式:

  • Persuade:访客做出决定并行动,设计即产品(落地页、营销、活动、定价)。
  • Operate:访客完成任务(应用 UI、仪表盘、编辑器、后台、设置、工具)。
  • Read:访客理解内容(文档、文章、指南、帮助、更新日志)。
  • Experience:访客置身作品之中(作品集、画廊、展示)。 模式仅持久化在对应的 surface brief 中。

核心原则

  • 全力以赴,不设对冲、不走捷径,交付物必须完整(用户需提供的素材除外)。
  • 大胆而宏大,追求独特、美丽、出色且极具启发性。
  • 以有界轮次验证,而非循环:完整构建后用一次批量轮次检查(Web 同时覆盖桌面与移动;原生平台覆盖已发布设备类别),一批修复全部问题,最多再确认一轮后停止打磨。开放式自我 QA 会浪费用户成本。
  • brief 优先:即便与饱和模式警告冲突,也尊重指定的美学、年代、材质、字体与配色;把清晰 brief 引向自身品味属于失败。
  • 精修保留既有身份、行为、文案与范围外内容;重构保留产品事实、内容、功能、原生可供性与约束,但把旧外观作为证据与反参考,并在 new-work 中选定替代世界、替换 DESIGN.md。
  • 视觉权威是证据而非文件名:缺失 DESIGN.md 本身并不代表项目是全新的。

限制与说明

  • 使用前需运行 Setup 的 context.mjs,并遵循其指令,不要重复运行。
  • 在分析与方向确定后、编辑 UI 前才加载 craft-floor.md。
  • teach 是其 init 的别名;craft 已废弃且不再增加内容。
  • init 写入 PRODUCT.md 后,无需重新运行 context.mjs 即可继续;当记录的平台为 ios、android 或 adaptive 时,init 会自行加载原生平台参考。
  • 绝不把修复漂移作为设计任务的副作用;CONTEXT_STALE 发现只报告、不处理,除非用户要求;标记为 auto 的发现除外。
  • 本技能的相关参考文档(routing.md、new-work.md、operate.md、各命令参考等)与具体脚本命令内容已在资料中给出,此处不改动代码内容。
  • 关于收费、价格、可用平台等具体信息,资料中暂未提供。