SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场impeccable

impeccable

前端与建站

查看项目

更新于 10-16 07:08

技能介绍

用途

impeccable 用于设计和迭代生产级前端界面，产出真实可运行的代码、明确的设计决策和出色的工艺。它适用于设计、重设计、塑形、评审、审计、打磨、澄清、提炼、加固、优化、适配、动画、着色、提取等前端设计相关工作。

主要能力

技能围绕两种设计语域展开：品牌（brand，营销、落地页、活动、长文内容、作品集，设计本身就是产品）与产品（product，应用 UI、后台、仪表盘、工具，设计服务于产品）。两者共享一套设计法则：

  • 色彩：使用 OKLCH；亮度接近 0 或 100 时降低彩度；不使用 #000 或 #fff；每个中性色向品牌色相偏移（彩度 0.005–0.01 即可）。先选色彩策略再选颜色，四种承诺轴策略为克制（Restrained）、投入（Committed）、全色板（Full palette）、浸染（Drenched）。
  • 主题：明暗不设默认，选择前先写一句物理场景（谁、在哪、何种环境光、什么情绪），场景句必须能强制得出答案。
  • 排版：正文行长上限 65–75ch；通过字号与字重对比建立层级（步进比≥1.25），避免扁平尺度。
  • 布局：变化间距形成节奏；卡片仅在确为最佳可供性时使用，禁止嵌套卡片；不要把所有内容都包进容器。
  • 动效：不动画 CSS 布局属性；使用指数缓出曲线（ease-out-quart / quint / expo），不用弹跳或弹性。
  • 绝对禁止项：侧边条纹边框（border-left/right 大于 1px 作为彩色强调）、渐变文字（background-clip: text 配渐变背景）、默认玻璃拟态、英雄指标模板（大数字+小标签+辅助统计+渐变强调）、雷同卡片网格、首选模态框。
  • 文案：每个词都要有价值，不重复标题；不使用破折号（em dash 或 --）。
  • AI 味测试：若有人能一眼断定“这是 AI 做的”，即失败；还需做类别反射检查，避免从领域名直接猜出主题与配色。

使用方式

前置设置（非可选）

在任何设计工作或文件编辑前，必须通过以下门禁，跳过会产生忽略项目的通用输出：

  • 上下文：已知 PRODUCT.md / DESIGN.md 加载器结果（来自 node .agents/skills/impeccable/scripts/load-context.mjs），失败则先运行加载器。
  • 产品：PRODUCT.md 存在且非空、非占位（无 [TODO] 标记、不少于 200 字符），失败则运行 $impeccable teach、刷新上下文后继续；绝不只凭用户原始提示合成 PRODUCT.md。
  • 命令：使用子命令时已加载对应命令参考，失败则先加载参考。
  • 工艺：$impeccable craft 需有用户确认的 shape 简报，teach / PRODUCT.md 不算 shape，失败则运行 $impeccable shape 并等待明确确认。
  • 图像：所需视觉探针/模拟图已生成，或已说明跳过原因。
  • 变更：以上所有活动门禁通过前，不得编辑项目文件。

Codex 风格智能体在编辑文件前须声明：IMPECCABLE_PREFLIGHT: context=pass product=pass command_reference=pass shape=pass|not_required image_gate=pass|skipped:<reason> mutation=open。对 $impeccable craft，shape=pass 仅在用户单独回复批准 shape 设计简报，或请求中已提供确认简报时有效；写完 PRODUCT.md、总结假设或自行起草未确认简报后不得标记 shape=pass。

上下文收集

项目根目录两个文件（大小写不敏感）：PRODUCT.md（必需，含用户、品牌、语气、反例、战略原则）、DESIGN.md（可选，强烈推荐，含颜色、字体、层级、组件）。一次调用加载两者：

node .agents/skills/impeccable/scripts/load-context.mjs

消费完整 JSON 输出，不要用 head、tail、grep 或 jq 截断。若输出已在会话历史中则不要重跑；例外：刚运行 $impeccable teach 或 $impeccable document（会重写文件），或用户手动编辑过。$impeccable live 已通过 live.mjs 预热上下文，若已运行 live.mjs 则本会话不再运行 load-context.mjs。PRODUCT.md 缺失、为空或占位时，运行 $impeccable teach 后用新上下文恢复原任务；若原任务是 craft，则先进入 shape 再做实现。DESIGN.md 缺失时，每会话提示一次（“运行 $impeccable document 获得更贴合品牌的输出”）后继续。

语域识别

设计前先识别语域，优先级：任务线索（“落地页”还是“仪表盘”）、聚焦表面（正在处理的页面、文件或路由）、PRODUCT.md 中的 register 字段，先匹配者胜。若 PRODUCT.md 缺少 register 字段（旧版），从其“Users”和“Product Purpose”部分推断一次并缓存，建议用户运行 $impeccable teach 显式添加。加载匹配参考：reference/brand.md 或 reference/product.md。

命令

  • 构建：craft [feature]（先塑形再端到端构建）、shape [feature]（写代码前规划 UX/UI）、teach（设置 PRODUCT.md 与 DESIGN.md 上下文）、document（从现有项目代码生成 DESIGN.md）、extract [target]（提取可复用令牌与组件到设计系统）。
  • 评估：critique [target]（带启发式评分的 UX 设计评审）、audit [target]（技术质量检查：无障碍、性能、响应式）。
  • 精修：polish [target]（发布前最终质量检查）、bolder [target]（放大安全或平淡的设计）、quieter [target]（收敛激进或过度刺激的设计）、distill [target]（剥离至本质、去除复杂）、harden [target]（生产就绪：错误、国际化、边界情况）、onboard [target]（设计首次运行流程、空状态、激活）。
  • 增强：animate [target]（添加有目的的动画与动效）、colorize [target]（为单色 UI 添加策略性色彩）、typeset [target]（改进排版层级与字体）、layout [target]（修复间距、节奏与视觉层级）、delight [target]（添加个性与难忘细节）、overdrive [target]（突破常规限制）。
  • 修复：clarify [target]（改进 UX 文案、标签与错误消息）、adapt [target]（适配不同设备与屏幕尺寸）、optimize [target]（诊断并修复 UI 性能）。
  • 迭代：live（视觉变体模式：在浏览器中选取元素并生成替代方案）。
  • 管理：pin <command> 与 unpin <command>，创建或移除独立快捷方式，使 $<command> 直接调用 $impeccable <command>。脚本写入项目中存在的每个 harness 目录：

node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <command>

有效 <command> 为上述任一命令。成功时确认新快捷方式，出错时原样转达 stderr。

路由规则

无参数时，按类别分组渲染上述命令表作为用户菜单并询问意图。首词匹配命令时，加载其参考文件并遵循其指示，命令名之后的内容为目标。首词不匹配时，视为通用设计调用，应用设置步骤、共享设计法则与已加载的语域参考，将完整参数作为上下文。此时设置（上下文收集、语域）已加载，子命令不再重新调用 $impeccable。若首词为 craft，设置仍先运行，但 reference/craft.md 接管后续流程；若设置因阻塞调用 teach，完成 teach、刷新上下文后恢复原命令与目标。

适用场景

适用于需要高质量前端界面设计与迭代的各类项目，包括营销落地页、品牌活动页、作品集、应用 UI、后台管理、仪表盘、工具界面等。既可用于从零构建功能，也可用于评审、审计、打磨、增强或修复现有界面。

限制

使用前必须满足前置门禁，尤其是 PRODUCT.md 必须存在且非占位；craft 命令需要用户确认的 shape 简报。技能明确禁止若干设计手法（侧边条纹边框、渐变文字、默认玻璃拟态、英雄指标模板、雷同卡片网格、首选模态框等），并禁止使用破折号。关于收费、价格、平台支持范围等具体信息，资料暂未提供。