导读:同样是给 AI 写指令,为什么有些 Skill 越写越长却越不好用,而真正成熟的 Skill 往往主文档克制、外挂清晰、自带防呆与验收闭环?本文以
frontend-design、ui-manager和email-design三份不同抽象层级的 Skill 为样本,抽丝剥茧地拆解它们背后的创作思路。
写 AI Skill,最容易滑向两个极端。
一种是写成“审美口号清单”:满屏都是“设计要高级、交互要流畅、拒绝 AI 味”这类正确但毫无抓手的形容词;另一种是写成“死板模板库”:把字号、色值、组件名和布局结构全焊死,换个业务场景立刻水土不服,AI 要么生搬硬套,要么彻底失控。
最近我细读了三份同出一脉的 Skill:frontend-design(通用前端设计)、ui-manager(应用内 UI 外观管理面板)和 email-design(HTML 邮件设计)。它们分别站在三个截然不同的抽象层级上——一份立通用方法论,一份做高内聚的功能模块,一份啃强媒介约束与强审美的垂直交付。
表面上看题材各异,但把它们的目录结构、主文档、参考手册、样板资产与校验脚本逐层剥开,背后竟是同一套极其老辣的工程写作心法。
一、先画边界,再搭骨架:用“渐进式披露”管住上下文
打开这三份 Skill 的主文件 SKILL.md,第一直观感受不是“全”,而是“薄”:ui-manager 不到 4KB,frontend-design 刚过 5KB,信息量最重的 email-design 也不过 7.5KB。
这不是偷懒,而是刻意为之的上下文治理。主文档是每次任务触发都要进入视野的“常驻大脑”,如果把字号表、校验范围、CSS 映射和验收用例全塞进去,只会稀释模型在核心流程上的注意力。作者的策略非常清晰:主干只立边界、主线与路由,细则全部按需外挂。

图 1:三份 Skill 均以轻量的 SKILL.md 为中枢,按任务形态分层外挂参考手册、资产样板与校验工具。
把三份 Skill 的结构并排对照,这种“按需配置、绝不冗余”的克制感一目了然:
| Skill 名称 | 抽象层级 | 主文档体量 | 外挂结构 | 明确排除的边界(红线) |
|---|---|---|---|---|
| frontend-design | 跨技术栈通用设计方法论 | ~5.2 KB | 4 份 references/(零代码资产) | 纯后端修复、单独的平面图片制作 |
| ui-manager | 高内聚功能模块(外观设置中心) | ~4.0 KB | 3 份 references/ + 3 份 assets/(默认配置、Token、预设) | 普通业务后台、账号权限管理、单页美化 |
| email-design | 强审美、强兼容的垂直媒介交付 | ~7.5 KB | 5 份 references/ + 4 张评审锚点图 + assets/ + 2 个校验/渲染脚本 | 纯文本通信、邮件群发与营销流程 |
这里有两个极值得借鉴的细节:
第一,把“不适用”写得和“适用”一样锋利。 三份文档在开篇 description 里都直接画了反面红线,从源头防止模型过度触发或越界扩写。写 Skill 时,明确“什么不该做”往往比罗列“能做什么”更能稳住输出边界。
第二,外挂目录完全服从任务形态,不搞形式主义的大一统。 frontend-design 强调跨框架中立,因此不带任何代码文件;ui-manager 是强契约功能,直接提供 ui-manager.defaults.json、theme-tokens.css 和 gradient-presets.json 作为集成起点,同时反复强调允许裁剪迁移;email-design 强依赖客户端渲染和视觉尺度,于是配齐了中性外壳、Python 静态检查脚本、Playwright 多宽渲染脚本和人工评审真图。每一份外挂文档都在主干的对应步骤被精准点名引用,真正做到了“用时再读”。
二、废除模板思维:不给标准答案,而是教 AI 做选择题
架构搭好之后,更难的问题在于:怎么让 AI 既稳定输出高完成度的作品,又不沦为机械套版的复读机?
这三份 Skill 给出的解法出奇一致——把具体需求往上抽一层,用信息关系与语义角色取代固定页面模板。
在 email-design 中,作者第一刀就砍向了传统的邮件分类法:
“把任务看成信息问题,不要先找‘最接近的邮件类型’。”
文档里没有“欢迎邮件模板”“账单邮件模板”或“营销邮件模板”,取而代之的,是 design-language.md 里的一张内容推导表:一个重要结论配少量条件该怎么组织、多项可比内容该怎么组织、时间顺序怎么排、观点与故事怎么排。文末还专门演示了同一套原则如何迁移到奖学金评审、物流延期、巡演招募等全然不同的新任务里。
到了 frontend-design 和 ui-manager,同样的抽象能力落在了“语义化”上。两份文档都禁止 AI 逐个元素随意写字号,而是将页面文字收束为五个语义角色(页面标题、关键统计、结构标题与标签、内容标识、动态数值),将外观编辑收束为版本化的配置契约。已有组件不必改名重写,只需把样式消费映射到同一套语义变量上。
更见功力的,是作者处理“审美尺度”这种玄学问题的方式。
写设计类 Skill 最怕空话。email-design 先直接拆穿伪高级——“不要把‘高级’解释成统一加阴影、渐变、玻璃效果或立体插画”“不要把‘单薄’的反馈机械地翻译成‘加更多模块’”——随后在 calibration.md(人工评审锚点)里祭出了一套极其聪明的正反锚定法。

图 2:通过“应学习 + 不要推导为”的成对约束,把参考案例变成可迁移的判断刻度,而非僵化的复刻模板。
文档内置了 4 张经多轮人工批注认可的设计图(发布到博客时,也可以直接搭配 email-design/references/visuals/ 中的实拍样例),每张图下方都紧跟着一组**“应学习”与“不要推导为”**:
- 编辑式邮件:学粗衬线标题与平静正文的反差、图文沿阅读方向形成的节奏,但不要推导为所有邮件都必须用宋体、米白背景和砖红引语。
- 验证码短消息:学“登录验证码”这种直述事情的自然命名(反例是把普通事务强拆成两行广告口号“输入验证码,继续登录。”),但不要推导为六位验证码和深蓝纹理卡是短邮件的固定皮肤。
- 新设备登录提醒:学用真实 Windows 官方标识和有因果关系的前后遮挡取代廉价的通用电脑符号,但不要推导为每封通知都要加一个倾斜窗口。
这几组“不要推导为”,几乎是整套 Skill 的点睛之笔。它把极易诱发模型过拟合的视觉案例,转化成了可迁移的决策证据。与此同时,三份 Skill 都在开头立下清晰的优先级:用户的明确要求、真实品牌规范与项目既有基线,永远高于 Skill 默认值。 连正文 16–18px、圆角 0–32px、动效 180ms 这样的具体数字,都被严谨标明为“起步参照,不是统一验收阈值”。有底线,却不僵化。
三、写透防呆细则:把大模型最爱做的“假动作”逐一堵死
顺着三份文档的 references/ 往下读,能强烈感受到一种在真实项目里踩过无数坑的实战质感。作者显然非常清楚大模型做前端和设计时最爱在哪些角落偷工减料,于是提前把这些高频“假动作”一个个写成明文禁区。
第一类禁区,堵的是“视觉敷衍”。
frontend-design 明确警告:用户要求放大文字且保持栏框尺寸时,应通过换行、重排或按约定增高来消化,绝不能靠“减小容器、隐藏溢出或暗中回缩字号”来假装尺寸合适;响应式检查不能只测桌面和手机两端,因为导航碰撞最常发生在“品牌与导航文字同时出现”的中间断点,而且“没有横向滚动条不代表布局正确”。ui-manager 对毛玻璃的拆解同样犀利:必须用 backdrop-filter 配半透明皮肤层,严禁用 filter: blur() 糊掉文字,也不能拿整卡 opacity 充数;更不能在纯色背景上写个 blur 数值就宣称生效,必须在纹理背景上实测 0px 与正模糊的视觉差异。
第二类禁区,堵的是“状态与架构糊弄”。
普通 AI 实现外观设置面板时,常常拿一个对象同时承接输入、预览和落盘,导致用户点一下预设就把当前主题改乱了,关掉面板也退不回去。ui-manager 和 frontend-design 直接把四个状态强行隔离开——applied(已持久化生效)、draft(独立编辑草稿)、preview(当前可见预览)、profiles(命名快照)——并把边界行为写死:载入档案只进预览、保存档案不自动应用、过期异步响应不能覆盖新草稿、删除档案或移除预览图前必须检查全局引用,防止误删其他档案仍在使用的持久化图片。
同样的严谨也落在浮层交互上:禁止每个选择器各管一个孤立的 open 布尔值,要求用 scope 和 parentId 统一管理树状关系;经 Portal 或 Teleport 挂载出去的浮层必须继承主题变量并纳入外部点击判断;同级菜单切换时,正在播退出动画的旧菜单必须立即放弃焦点与点击响应,绝不允许出现新旧叠层或退出层拦点击的窘境。
第三类禁区,堵的是“细节失真与越界”。
三份 Skill 对真实感有着近乎苛刻的洁癖。email-design 规定品牌与系统图标必须取自可靠官方素材,缺素材时宁可用清楚的文字或通用符号,绝不拿似是而非的图形冒充具体产品;正式成稿不留示例域名,也不替用户编造日期、价格或客户关系。frontend-design 与 ui-manager 则严防改动蔓延:局部修复不借机重写整页,外观配置绝不越权改写业务阈值,使用模拟数据时必须明示来源。
把“正确做法”写清只是及格线,把模型最容易钻的空子写成防呆条文,Skill 的下限才真正稳住了。
四、把验收写成硬契约:用实证闭环替代“自夸式交付”
很多 Skill 写到“产出文件”就结束了,留给 AI 一大片自由发挥的空间去自我表扬。而这三份 Skill 最打动人的地方,恰恰在于后半段的“收口”——把验收从口头汇报拉回到可观察的实证闭环。

图 3:上层用状态隔离管住交互复杂度,下层用“构建 → 静态检查 → 真实渲染 → 诚实汇报”的实证闭环兜住交付质量。
在 email-design 里,作者直接把确定性校验交给脚本:check_email.py 按 preview、template、send-ready 三种模式分别排查资源、动态语法与遗留占位符;render_email.cjs 驱动真实浏览器按桌面、手机、窄屏截全页图,并输出横向溢出、未加载图片、小号灰字等指标。但作者同样没有神化工具,紧接着写下三句极清醒的约束:“静态检查不判定审美”“截图文件生成成功不等于做过视觉检查”“浏览器预览不等于真实邮箱兼容性验证”。工具负责扫雷,眼睛负责判断,互不替代。
在 frontend-design 和 ui-manager 里,这种实证精神落在了“按改动选矩阵”和逐条可观察的验收场景表上。文档反复敲打同一个底线:样式变量存在、组件单测通过,都不代表字号、模糊或布局在真实浏览器里已经生效;不要写只比对 CSS 类名的测试来替代视觉检查。 改了主题,就把下拉菜单、弹窗和搜索框全点开看有没有漏出固定白底;做性能调优,先测冷启动与触发路径,有证据再加缓存或防抖。
最后落到交付话术上,三份 Skill 保持着高度一致的克制:
- 严格区分已实现、已验证、已发布,没有明确授权,绝不把设计任务擅自扩大成部署;
- 缺少渲染环境或未覆盖某些浏览器时,如实说明未检项,绝不假装测过;
email-design末尾甚至直接写下一句点破真相的提醒:
“不要宣称‘完全没有 AI 味’;由实际内容和人工评审验证效果。”
读完这一句,作者的创作底色就完全清晰了:他并不试图把 AI 包装成无所不能的天才,而是用一整套边界、锚点与实证机制,把 AI 驯化成一名懂取舍、知深浅、拿证据说话的资深工程搭档。
结语:一份高阶 Skill 的底层公式
把 frontend-design、ui-manager 和 email-design 纵向拉通,已经能提炼出一套足够扎实的高阶 Skill 创作公式:
- 架构上做减法,边界上做乘法:主文档只留心法、主线和路由,细节下沉到参考手册,按任务形态按需配置样板或脚本;用锋利的“不适用”守住触发精度。
- 抽象上提一层,案例上正反锚定:不堆具体业务模板,而是提炼信息关系、语义角色与状态契约;凡给参考范例,必配“学什么”与“不要推导成什么”,防死板、防过拟合。
- 经验上沉到底,把坑写成防呆条文:少写放之四海而皆准的空话,多写 AI 在真实场景里最容易敷衍的假动作禁区。
- 交付上建闭环,用诚实换信任:把能程序化检查的交回脚本,把需要看画面的落到实测场景表,分清实现、验证与发布的边界,拒绝一切自夸式验收。
写普通 Prompt,是在教 AI “这一次怎么答”;写高阶 Skill,是在教 AI “这一类问题该怎么想、怎么查、以及在哪儿停手”。看懂了这三份文档背后的取舍,也就摸到了把隐性专业经验沉淀为可复用 AI 能力的真正门道。