适合谁
前端质量 / UI 审计:适合审查和升级已有网站的视觉、响应式、可访问性和交付质量。
Codex 用法
优先按具体技能或原项目安装方式使用,不建议把归档目录整包复制。
Codex 可优先使用 .codex/skills,常用链路:audit -> critique -> polish。
许可证 / 风险
Apache-2.0。适合复用,但仍需保留原许可声明。
推荐工作流
audit 找技术质量问题;critique 看信息架构和体验;normalize 统一设计系统;polish 做交付前收尾。
什么时候用
当页面已经能跑,但看起来模板化、移动端粗糙、层级不清或缺少可访问性细节时,用这组技能收益最高。
Codex 落地
优先安装或复制 `.codex/skills` 下的明确技能。不要一次调用所有命令,先 audit,再按 P0/P1 问题逐项修。
🎨 Impeccable 技能拆解全景图
像搭积木一样
看懂这个系统
这个项目是给 AI 编程工具用的"设计教练",帮它做出漂亮的网页。不用懂代码,看完这张图你就明白了。
第 5 层 · 门面
🎨
网站展示层 (public/)
你在浏览器里看到的网页。包括首页、案例展示、反面教材页面。你能访问的一切都在这里。
第 4 层 · 工具箱
🛠️
编译输出层 (dist/)
把源文件变成不同 AI 工具能用的格式。比如给 Cursor 用的、给 Claude Code 用的、给 Gemini 用的 —— 同一个人化不同的妆。
第 3 层 · 菜谱
📖
源技能层 (source/skills/)
20 个设计"口诀"。比如 /audit 是"挑毛病"、/polish 是"打磨细节"、/delight 是"加点惊喜"。每个技能都有详细的指导手册。
第 2 层 · 工厂
🏭
构建系统 (scripts/, lib/)
自动化流水线。把技能从"一份原版"复制编译成"多份定制版",适配不同 AI 工具的格式要求。
第 1 层 · 地基
🧱
基础设施 (server/, functions/)
运行在云端的服务器。处理网站访问、文件下载、用户反馈等请求。
1
🎨 指导 AI 做出漂亮网页
这是 Impeccable 的核心超能力。它教会 AI 什么该做、什么不该做。比如"别用 Inter 字体"、"别在彩色背景上用灰色字"、"别把所有东西都塞进卡片里"。
/frontend-design → 生成一个"看起来像人做的"网页
2
🔍 审计体检
像体检一样全面检查网页。看看颜色对比够不够、响应式有没有问题、加载快不快。
/audit → "报告:发现 5 个问题"
3
✨ 打磨抛光
出货前的最后一道工序。对齐像素、调整间距、统一字体。让细节经得起放大镜看。
/polish → "好了,可以发货了"
4
🎭 风格改造
把平淡的设计变得有趣。或者把太花哨的弄得更低调。完全看你需要。
/bolder → "再大胆一点!"
/quieter → "低调一点"
5
🎬 加点"魔法"
加上恰到好处的动画。让页面动起来,但不要太过分。
/animate → "给按钮加个hover效果"
6
📝 文字润色
把"技术黑话"变成人话。让按钮文字、提示信息更容易懂。
/clarify → "别叫 Error 404 了,说'页面消失了'"
7
🧩 组件提取
把重复的代码变成可复用的零件。一次编写,到处使用。
/extract → "这个按钮我以后还要用"
8
📱 响应式适配
让同一个页面在手机、平板、电脑上都好看。不是简单缩小,而是因地制宜。
/adapt → "手机上这样排"
👤
开发者
"帮我做个官网,要那种看起来不像 AI 做的。"
🎨
/frontend-design(设计教练)
"收到!先用这个技能。需要知道:谁来用这个产品?想表达什么感觉?"
开发者:"给设计师用的工具,要专业、简洁、有品味。"
🍡
Bun(料理机)
"[执行] 好嘞!把源技能编译成 Cursor 能读懂的格式,放到 dist/ 目录。"
🔍
/audit(体检医生)
"报告:发现 3 个问题
1. 按钮颜色对比度不够
2. 手机端导航有点挤
3. 加载慢了一点点"
✨
/polish(打磨匠)
"好了!像素对齐、间距统一、字体大小调匀,细节都修好了。"
🎭
/bolder(风格大师)
"收到!加大标题、加粗重点、颜色再鲜明一点。"
🎬
/animate(动画师)
"来了!页面进入加交错效果,按钮 hover 加微动效。"
🚀
Bun(打包)
"bun run build && wrangler pages deploy"
☁️
Cloudflare Pages(铺面)
"网站上线了!全球 CDN 分发,访问速度有保障。"
🗄️
Supabase(数据库)
"[记录] 构建历史已存:谁改的、什么时候、改了啥,方便回溯。"
📝
/clarify(文字润色师)
"别写'Submit'了,改成'发送消息'更易懂。"
🧩
/extract(组件提取师)
"提取成功!这个按钮以后可以复用。"
📱
/adapt(响应式大师)
"手机端重新排版:导航收进汉堡菜单,卡片改成纵向。"
🤫
/quieter(降噪师)
"收到!去掉一些装饰,把空间让给内容。"
💳
Stripe(收银员)
"钱收到了!@Supabase,给这个用户开通 Pro 版。"
🎉
Supabase
"[记录] Pro license 已开通!"
WebCodecs
像视频网站的"播放器内核"。网页要播视频,得有个东西来解压缩视频文件、把一帧帧画面显示出来。WebCodecs 就是浏览器内置的这个播放器底层。
FFmpeg
像视频届的"瑞士军刀"。能转换格式、剪辑、加字幕、做特效。命令行工具,很强大但需要学习。
H.264
像视频的"压缩算法"。一段 1GB 的视频,用 H.264 压完可能就 100MB 了,但看起来差不多。几乎是所有视频网站通用的格式。
30fps
像翻书的速度。每秒翻 30 页,书里的内容就像动起来一样。电影一般是 24fps,网页动画 30fps 就挺流畅了。
Mux
像视频托管商。帮你存视频、CDN 分发、还提供播放统计数据。收费但省心。
MP4 容器
像快递盒。把视频文件、音频文件、字幕"打包"成一个文件。MP4 就是最常见的那个"盒子"。
Motion
动效库,像做动画的"画具"。帮你做交错入场、滚动视差、页面转场等效果。
Playwright
像自动化测试员。帮你模拟点击、填表、截图,检测网页是否正常工作。