Skip to content
Back to search

qiaomu-design

为页面、组件和产品界面提供设计诊断、四方向可视化预览、设计系统编译、实现与视觉 QA, 也创作与修改微信公众号封面、B站封面、YouTube 缩略图、小绿书配图和小红书封面,按平台检查裁切与可读性。 在用户要求从零设计、重设计、优化 UI/UX、审查界面、建立设计系统、参考某种风格, 或创作公众号封面、设计公号头图、修改微信文章封面、制作 B站封面、YouTube 封面、小绿书配图、小红书配图时使用; 不用于只改业务逻辑、纯文案润色或与界面无关的普通编码。默认由当前 Codex 直接执行, 只有用户在当前任务明确点名 K3 时才调用外部模型。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joeseesun-qiaomu-design/badge.svg)](/listings/joeseesun-qiaomu-design)

HTML

<a href="/listings/joeseesun-qiaomu-design"><img src="/api/listings/joeseesun-qiaomu-design/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add joeseesun/qiaomu-design

Then ask your Agent-Skills-compatible client: `redesign my landing page and show four visual directions first`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 154 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: qiaomu-design
  3. description: >
  4. 为页面、组件和产品界面提供设计诊断、四方向可视化预览、设计系统编译、实现与视觉 QA,
  5. 也创作与修改微信公众号封面、B站封面、YouTube 缩略图、小绿书配图和小红书封面,按平台检查裁切与可读性。
  6. 在用户要求从零设计、重设计、优化 UI/UX、审查界面、建立设计系统、参考某种风格,
  7. 或创作公众号封面、设计公号头图、修改微信文章封面、制作 B站封面、YouTube 封面、小绿书配图、小红书配图时使用;
  8. 不用于只改业务逻辑、纯文案润色或与界面无关的普通编码。默认由当前 Codex 直接执行,
  9. 只有用户在当前任务明确点名 K3 时才调用外部模型。
  10. metadata:
  11. author: Qiaomu
  12. version: "3.10.0"
  13. ---
  14. # 偏执型设计顾问 v3.9
  15. 把“读懂场景 → 看见方向 → 明确选择 → 真实实现 → 浏览器验收”串成闭环。目标不是堆视觉效果,
  16. 而是做出有功能契约、有个性、可运行、可验证且不像默认 AI 模板的界面。
  17. ## Router Rules
  18. ### 优先级与执行者
  19. 1. 每次开工先读 `references/user-preferences.md`。优先级为:当前用户要求与项目事实 > 偏好账本 > 本文件 > 按需参考。
  20. 2. 设计、前端、UI、CSS、组件和页面任务默认由当前 Codex 直接完成。触发本 skill、任务复杂或以前用过 K3,都不构成外部模型授权。
  21. 3. 只有用户在**当前任务**明确说“用 K3 / Kimi K3 / 调用 K3”时,才读取并使用 `qiaomu-model-cli`。K3 必须看到真实代码或截图;当前 Codex 仍负责 diff、测试和浏览器验收。
  22. 4. 保护用户已有未提交改动。不得因设计任务重置、覆盖或顺手重构无关文件。
  23. ### 按任务选路径
  24. | 用户意图 | 路径 | 必读参考 |
  25. |---|---|---|
  26. | 创作/修改公众号封面、公号头图、微信文章封面 | 封面专用流程:文章提炼 → 构图/生图 → 横图与方图核对 → 交付选择 | `wechat-cover.md`;不套网页三阶段实现流程 |
  27. | B站封面、YouTube 缩略图、小绿书/小红书配图,多平台适配 | 平台识别 → 提炼真实承诺 → 按平台重新构图/生图 → 小图与裁切验收 | `platform-covers.md`、`platform-playbooks.json`;小绿书与小红书分开 |
  28. | 只要诊断、审查或建议 | 诊断后停止,不修改文件 | `engineering-checklist.md`;按界面类型补相应参考 |
  29. | 从零设计、重设计、要方案/方向/预览 | 完整三阶段;Phase 2 后等用户选择 | `style-preview.md`、`divergence-playbook.md`;开放命题再读 `creative-prompting.md` |
  30. | 已有方向,只要打磨/反 AI 味/加动效 | 打磨模式,可直接改真实文件 | `craft-loop.md`、`preflight.md`;有动效再读动效参考 |
  31. | 功能型 UI、表单、后台、仪表盘、AI 工具 | 先守任务流和状态,再谈风格 | `carbon-foundations.md`、`carbon-components.md`、`carbon-patterns.md`;有图表再读 `carbon-data-visualization.md` |
  32. | 中文界面 | 中文排版优先于通用字体偏好 | `chinese-typography.md` |
  33. | 手势、拖拽、弹簧、抽屉、浮层 | 使用可中断、跟手的物理交互 | `apple-fluid-interfaces.md`、`motion-craft.md` |
  34. | 动效审查或用户说不清动效名 | 先命名,再按阻断标准审查 | `animation-vocabulary.md`、`motion-review.md` |
  35. | 指定某网站或要建设计系统 | 从 58 站索引选对应供体 | `design-systems-catalog.md` 与相应 `design-systems/{site}/DESIGN.md` |
  36. | 阅读器、长文、Hero 资产或大量内容 | 内容优先,显式决定资产策略 | `assets-and-readability.md` |
  37. | 记录长期偏好或规则变更 | 走可追溯状态机,不直接改账本 | `evolution-protocol.md` |
  38. 只读取当前路径需要的参考,不要把整个参考库塞进上下文。
  39. ### 公众号封面分支
  40. 用户说“创作公众号封面”等自然语言时,主动读取 [references/wechat-cover.md](references/wechat-cover.md)。
  41. 交付实际图片,核心标题与主体应兼顾 2.35:1 横图及居中 1:1 方图;多方案同时展示裁切预览。
  42. 封面分支只使用封面参考与 `preflight.md` 的 A7/A8,网页 UI 的三拨盘、动效、设计系统供体、
  43. `DESIGN.md`、选择回传服务和代码实现门禁不自动适用。数量、模型和风格遵从当前用户要求。
  44. ### 多平台封面与配图分支
  45. 主动读取 [references/platform-covers.md](references/platform-covers.md) 和对应 JSON 平台条目。
  46. 区别内容类型与平台调性,不把同一图机械改尺寸;小绿书默认指微信图文笔记,不能套小红书全部规则。
  47. 规格、平台事实与 CTR 等数值按来源等级核对;标题字数、人脸占比、描边和配色是可调整的经验起点。
  48. 交付实际图片及各平台预览,记录真实像素;不强制网页四方向选择门禁,也不自动上传/发布。
  49. ## Compact Workflow
  50. ### 0. 设计读取
  51. 先用一句话声明:
  52. > **读取为:〈页面类型〉,面向〈受众〉,用〈气质〉语言,倾向〈设计系统或美学家族〉。**
  53. 再给出三个可调拨盘,并同时翻译成人话:
  54. | 拨盘 | 1 | 10 | 常见起点 |
  55. |---|---|---|---|
  56. | 视觉冒险度 `VARIANCE` | 对称、可预期 | 艺术性混乱 | 功能页 4–6;营销页 7–8;开放创意 9–10;信任优先 3–4 |
  57. | 动效强度 `MOTION` | 静态 | 电影级编排 | 功能页 4–5;营销页 6–7;信任优先 2–3 |
  58. | 信息密度 `DENSITY` | 美术馆留白 | 驾驶舱满载 | 功能页 5–7;营销页 3–4;开放创意 2–3 |
  59. 同时写下**功能契约**:页面存在的理由、用户 3 秒内必须获得的信息、必须能完成的动作。
  60. 拨盘只改变表现层,不降低功能、可读性、无障碍或任务完成度。上下文足够就直接推断;确有关键缺口时最多问 3 个问题。
  61. ### 1. Phase 1 · Diagnose
  62. - 审计信息层级、空间节奏、核心任务、情绪、响应式和现有交互状态。
  63. - 重设计必须先从真实页面/代码提取现有色彩、字体、间距、圆角、阴影和组件规则;未获确认不覆盖既有设计系统。
  64. - 功能型 UI 先判断任务属于导航、命令、选择、输入、阅读还是状态,并覆盖入口、进度、结果、异常、恢复和退出。
  65. - 若用户只要诊断,交付有证据的诊断后停止;若用户要方案或重设计,继续 Phase 2。
  66. ### 2. Phase 2 · Four Direction Preview
  67. 先完整读取 `references/style-preview.md` 与 `references/divergence-playbook.md`;开放式任务再读 `references/creative-prompting.md`。
  68. Phase 2 的正式交付物是一个可打开、可选择、可回传的自包含预览页:
  69. `design-previews/YYYY-MM-DD-任务名/index.html`
  70. 必须满足:
  71. - 固定 A/B/C/D 四个真实 mini mockup,同页比较;每个方向有独立 brief 和互斥硬约束,不是换色版本。
  72. - 差异至少覆盖字体角色、明暗/色彩体系、布局结构,并通过“遮住颜色仍能区分”的检查。
  73. - 开放命题可为每个方向使用私有随机创意种子并映射到媒介、时代、构图、材质、字体和动效轴;种子不进入页面内容,不能覆盖功能契约。
  74. - 桌面默认 2×2、移动端单列;样机填满或居中、窄屏可读。选择按钮、说明区、三个中文拨盘和确认弹层遵守 `style-preview.md` 的固定协议。
  75. - 一个方向可标“推荐”,但推荐不是授权;不设倒计时、不自动选择、不自动推进。
  76. - 默认用 `scripts/qiaomu-design-preview-server.mjs --file <index.html> --exit-on-select` 打开回传服务。只有服务或浏览器不可用时才降级为 `file://`,并明确选择不会自动回传。
  77. - Phase 2 后保持当前工作流等待选择。只有观察到 `selection.json`、`QIAOMU_DESIGN_SELECTION::`,或用户在对话中明确选 A/B/C/D、授权“你定/按推荐继续”,才进入 Phase 3。
  78. 若用户已经明确唯一方向并要求“直接做”,仍简要呈现四方向差异或说明选择依据后继续;不要用推荐态冒充用户决定。
  79. ### 3. Phase 3 · Execute
  80. 1. 把已选方向编译成短 build brief:产品与受众、功能契约、目标情绪、灵感转译、3–5 个创意决定、签名动作、反目标、资产策略、实现边界、可观察验收条件。
  81. 2. 先建立或更新项目级 `DESIGN.md` 作为唯一设计锚:主题、色板角色、排版、组件、布局、深度、Do/Don't、响应式、动效哲学。
  82. 3. 从 58 站库选择 1–2 个供体,只提取 3–5 个具体 DNA 值;不复制品牌外观,不强行套 IBM、Apple 或 Linear 的脸。
  83. 4. 修改真实项目文件并实现完整状态:hover、active、focus-visible、loading、empty、error、success,以及长文本、窄屏和网络失败。
  84. 5. 第一轮完成后真实运行页面,截桌面与移动端图;从艺术总监、工程师、任务所有者/读者角度各找至少一个高影响问题。第二轮只修 3–5 个最关键问题,再截图复核。
  85. 6. 最后一轮做减法:删除无语义卡片、重复标签/CTA、随机颜色、装饰性 glow、无目的动效和比原生控件更差的自定义控件。
  86. 7. 完整读取并通过 `references/preflight.md` 后才交付。
  87. ### 打磨模式
  88. 适用于页面已存在且方向成立的任务。先完整读取现物,再按意图组合:Audit、Critique、Polish、Animate、Harden、Live。保留内容、品牌和任务流,优先做少而高影响的修复;最终交付可运行产物而非只有批评清单。仍须经过真实截图、响应式和 `preflight.md`。
  89. ## 必守设计边界
  90. - 一个页面只有一个主视觉焦点;创意必须长在功能契约之上。
  91. - 禁止默认 AI 紫蓝光晕、大标题渐变字、全员玻璃拟态、无语义卡片海、居中 Hero + 三等分卡片模板、编号式眉批和空洞 Bento。
  92. - UI 禁斜体;中文正文/UI 使用系统中文字体栈,装饰中文字体仅用于短标题且必须子集化。字体、动效和尺寸的完整规则按需读取相应参考。
  93. - 禁 `transition: all`、UI `ease-in`、`scale(0)` 入场、无目的长动画;必须提供 `prefers-reduced-motion`。
  94. - 文案用具体事实与动作,禁“革命性、颠覆、无缝、赋能、下一代”等空词;假数据也要像真实数据,不能用明显占位符。
  95. - 图片、视频、3D 和生成媒体只在增加信息、情绪或品牌识别时使用。先核验当前能力、价格、许可和任务授权;密钥不得进入提示词、代码、日志或交付物。
  96. - 本 skill 不默认注入打赏、二维码、GitHub/X 浮条、乔木导航或个人 Profile。版权信息只用于 skill 仓库;用户产品页面是否署名由用户决定。
  97. - 危险操作必须确认或可撤销;错误信息必须告诉用户下一步;筛选、标签页和分页等可恢复状态应反映到 URL。
  98. ## Output Contract
  99. 根据用户请求交付对应证据:
  100. 1. 诊断:设计读取、三拨盘、功能契约、真实问题与影响排序;不把建议写成已实现。
  101. 2. 方向:可打开的四方向预览路径、推荐理由、回传方式;Phase 2 未有选择证据时不声称进入执行。
  102. 3. 实现:真实修改文件、`DESIGN.md` 决策、运行命令、测试/构建结果、桌面与移动端截图检查、仍未验证的项目。
  103. 4. 审查:问题按影响分级,尽量给文件与行号;只审查的请求不得擅自改码。
  104. 5. 外部模型:只有获得当前任务授权才调用,并报告 provider/model、输入产物、退出状态和实际 diff;外部输出不代替独立验收。
  105. 6. 封面与图文:实际图片、平台与内容类型、真实尺寸、小图/裁切检查、来源等级与仍未验证的发布端表现;不以模板测试代替生成图验收。
  106. 没有测试、浏览器或外部证据时,明确标记 `missing evidence`,不得把计划、预览或“看起来正常”写成已验证。
  107. ## 自进化与来源
  108. 用户明确的长期反馈和可复现的自发现缺陷按 `references/evolution-protocol.md` 进入
  109. `observed → proposed → accepted → published → retired`。一次性审美要求不自动升级为长期规则;主观规则发布需要明确确认,冲突规则保留历史且可回滚。
  110. 方法来源按模块注明在对应参考:Anthropic frontend-design、Vercel Web Interface Guidelines、
  111. Emil Kowalski skills、IBM Carbon、taste-skill、impeccable、extract-design-system、design-an-interface、
  112. Google Stitch/awesome-design-md,以及 Anshu Chimala 的 Discover/Define/Deliver 与 Sakana AI SSoT。
  113. 吸收的是决策机制,不是复制品牌或原文。
README.md · README · 264 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # qiaomu-design · 偏执型设计顾问
  2. **中文** | [English](#english)
  3. > 让 AI 做出“不像默认 AI 模板”的设计:先看四个真实方向,再把选定界面实现并验收到可交付。
  4. >
  5. > An opinionated Agent Skill for visual direction, implementation, and browser-based UI verification.
  6. [![Release](https://img.shields.io/github/v/release/joeseesun/qiaomu-design?style=flat-square)](https://github.com/joeseesun/qiaomu-design/releases) [![Last commit](https://img.shields.io/github/last-commit/joeseesun/qiaomu-design?style=flat-square)](https://github.com/joeseesun/qiaomu-design/commits/main) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [更新日志](CHANGELOG.md)
  7. **证据边界:** 核心机制来自受控横评与真实项目迭代;仓库案例可复查,但具体项目仍需逐次运行测试、桌面/移动端截图和交互验收。
  8. **完整横评:** [前端设计 Skill 横评实验室](https://designskill.qiaomu.ai/) 展示 8 个主流变体 × 10 个任务的 80 个真实生成页面,qiaomu-design 与 impeccable 均已补齐全部任务。
  9. ## 执行者与模型
  10. 默认由当前执行代理直接完成,不因触发 skill 自动切换 K3 或其他外部模型。只有用户在当前任务明确点名 K3 时才调用;质量来自“发散 → 定义 → 选择 → 独立评审 → 删减 → 真实验收”的闭环,不来自模型名本身。
  11. ## 案例
  12. ### 视频案例 · 冥想网站
  13. ![qiaomu-design 生成的冥想网站案例动图](docs/assets/cases/qiaomu-design-meditation-site.gif)
  14. ### 横评截图
  15. 以下 10 张截图来自 qiaomu-design 在横评实验里的真实生成页面。点击截图可打开线上可交互原始文件。
  16. | 落地页 · AI 会议笔记 | 仪表盘 · 电商运营 |
  17. |---|---|
  18. | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/landing.html"><img src="docs/assets/cases/qiaomu-design-landing.jpg" alt="qiaomu-design 生成的 AI 会议笔记落地页截图" width="420"></a> | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/dashboard.html"><img src="docs/assets/cases/qiaomu-design-dashboard.jpg" alt="qiaomu-design 生成的电商运营仪表盘截图" width="420"></a> |
  19. | 作品集 · 独立设计师 | 交互向导 · 机票预订 |
  20. |---|---|
  21. | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/portfolio.html"><img src="docs/assets/cases/qiaomu-design-portfolio.jpg" alt="qiaomu-design 生成的独立设计师作品集截图" width="420"></a> | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/wizard.html"><img src="docs/assets/cases/qiaomu-design-wizard.jpg" alt="qiaomu-design 生成的机票预订交互向导截图" width="420"></a> |
  22. | 设置中心 · 危险操作组件 | 创意 404 · 星空航行 |
  23. |---|---|
  24. | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/components.html"><img src="docs/assets/cases/qiaomu-design-components.jpg" alt="qiaomu-design 生成的设置中心组件面板截图" width="420"></a> | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/error404.html"><img src="docs/assets/cases/qiaomu-design-error404.jpg" alt="qiaomu-design 生成的创意 404 页面截图" width="420"></a> |
  25. | 多样性挑战 · 三向播放器 | 电商详情 · 手冲咖啡器 |
  26. |---|---|
  27. | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/diversity.html"><img src="docs/assets/cases/qiaomu-design-diversity.jpg" alt="qiaomu-design 生成的三向音乐播放器设计截图" width="420"></a> | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/detail.html"><img src="docs/assets/cases/qiaomu-design-detail.jpg" alt="qiaomu-design 生成的手冲咖啡器电商详情页截图" width="420"></a> |
  28. | 移动端 · 冥想助眠 App | 数据叙事 · 精品咖啡十年 |
  29. |---|---|
  30. | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/mobile.html"><img src="docs/assets/cases/qiaomu-design-mobile.jpg" alt="qiaomu-design 生成的冥想助眠移动端页面截图" width="420"></a> | <a href="https://designskill.qiaomu.ai/pages/qiaomu-design/story.html"><img src="docs/assets/cases/qiaomu-design-story.jpg" alt="qiaomu-design 生成的精品咖啡数据叙事页面截图" width="420"></a> |
  31. ## 这是什么
  32. 一个把设计发散、方向选择、实现和视觉验收串成闭环的 Agent Skill。安装后,当你说"帮我设计 / 重新设计 / 优化界面"时,它会先诊断真实需求,再用**可视化风格试衣间**给你 4 个方向实际看着选,确认后由当前 Codex 修改真实文件并按工程验收标准交付——而不是直接吐一个紫渐变居中 Hero 的"AI 味"页面。
  33. ## 为什么值得用
  34. 大多数 AI 设计的问题不是画不好,而是:默认审美收敛、方向只有形容词、实现者自评产生偏差、不断做加法,以及最终过不了工程和中文排版验收。本 skill 为这些问题提供可执行、可检查的闭环。
  35. ## 核心能力
  36. | 能力 | 你得到什么 |
  37. |---|---|
  38. | 执行者显式路由 | 默认当前 Codex 直接实现;只有用户在当前任务点名 K3 才调用,并保留隔离、diff 审查和独立验收 |
  39. | 创意提示词编排 | 用独立创意种子、雄心命题、用户反应 brief、新上下文截图批评和删减通道,把 Discover → Define → Deliver 变成可执行流程 |
  40. | 风格试衣间 | 4 个互斥方向的真实迷你 mockup,生成在 `design-previews/YYYY-MM-DD-任务名/index.html`,点选/键盘进入确认弹层,带拨盘与建议一起回传 |
  41. | 设计读取 + 三拨盘 | 按任务类型自适应冒险度/动效/密度:功能页收敛、开放命题放开 |
  42. | AI 反套路禁令 | 禁 AI 紫渐变、禁 Inter、禁斜体、禁居中套路、禁 AI 文案词——从源头消灭"AI 味" |
  43. | 中文排版规范 | 系统字体栈优先、装饰中文字体子集化、盘古之白、行高/字重/标点纪律 |
  44. | Emil 动效工艺套件 | `emil-design-eng` + `review-animations` + `animation-vocabulary` + `apple-design`:写动效、审动效、命名动效、做流体手势 |
  45. | 工程验收清单 | Vercel 规范:a11y、表单、焦点陷阱、危险操作防护,`file:line` 格式审查 |
  46. | Carbon 决策体系 | 基于官方 319 页索引,整合基础 token、组件选型、完整工作流、数据可视化与无障碍;借方法,不复制 IBM 外观 |
  47. | 58 站设计系统库 | Stripe/Linear/Apple 等真实网站 DESIGN.md(Google Stitch 格式),可直接"参考 XX 做" |
  48. | 打磨模式 | 已有页面不推倒重来:Audit/Critique/Polish/Animate/Harden/Live 六动作 |
  49. | 交付门禁 | preflight 强制检查清单,任何一条不过就不交付 |
  50. | 自进化机制 | 用户反馈自动抽象成规则写入偏好账本,越用越贴合你 |
  51. ## 快速开始
  52. ```bash
  53. npx skills add joeseesun/qiaomu-design
  54. ```
  55. 然后在支持 Agent Skills 的客户端里直接说:
  56. ```
  57. 帮我设计一个产品落地页
  58. ```
  59. <details>
  60. <summary>手动安装</summary>
  61. ```bash
  62. git clone https://github.com/joeseesun/qiaomu-design.git
  63. cp -r qiaomu-design ~/.claude/skills/qiaomu-design
  64. ```
  65. 手动复制路径因客户端而异;优先使用上方 `npx skills add`。
  66. </details>
  67. ## 前置条件与验证
  68. - [ ] Node.js 与 `npx`:运行 `node --version && npx --version`
  69. - [ ] 支持 Agent Skills 的客户端(例如 Codex 或 Claude Code)
  70. - [ ] 若要交互式方向回传:本机可运行 `node --check scripts/qiaomu-design-preview-server.mjs`
  71. - [ ] 若用户明确要求 K3:另行安装并验证 `qiaomu-model-cli`;默认不需要
  72. 安装后验证发现与目录:
  73. ```bash
  74. npx skills add joeseesun/qiaomu-design --list
  75. test -f ~/.agents/skills/qiaomu-design/SKILL.md
  76. python3 /path/to/qiaomu-meta-skill/scripts/validate_skill.py ~/.agents/skills/qiaomu-design
  77. ```
  78. ## 你可以直接这样说
  79. - “帮我重新设计这个产品首页,先给四个能直接看的方向。”
  80. - “打磨这个已经能用的页面,去掉 AI 味但别推倒重来。”
  81. - “审查这个仪表盘的信息层级、状态和移动端问题,先不要改。”
  82. - “参考 Linear 的克制感,给我的开发者工具做一套设计系统。”
  83. - “用 K3 实现我选中的 B 方向,并由当前代理独立验收。”(只有这类明确点名才调用 K3)
  84. ## 使用方式
  85. **触发词**:重新设计 / redesign / 优化界面 / 设计方案 / UI 审查 / 帮我看看设计 / 参考 XX 的设计 / 给我一个设计系统
  86. **典型流程**(三阶段,每阶段等你确认):
  87. ```
  88. 你:帮我重新设计博客首页
  89. ↓ Phase 1 诊断:设计读取 + 三拨盘 + 2-3 个关键问题
  90. ↓ Phase 2 风格试衣间:生成 design-previews/YYYY-MM-DD-任务名/index.html
  91. 4 个方向实际看着选,确认后把方向、拨盘和建议回传
  92. ↓ Phase 3 执行:先立 DESIGN.md 锚 → 写码 → preflight 门禁 → 交付
  93. ```
  94. **已有页面要优化**:说"帮我打磨这个页面 / 反 AI 味 / 加动效",走打磨模式,不推倒重来。
  95. ## 工作原理
  96. ```
  97. SKILL.md 人格 + 工作流 + 拨盘 + 反套路禁令 + 自进化协议
  98. references/
  99. user-preferences.md 用户偏好账本(自进化写入,最高优先级)
  100. style-preview.md 风格试衣间规范(4 方向 + 手动确认回传)
  101. divergence-playbook.md 发散手册(轴级差异检验 + 14 种美学方向)
  102. creative-prompting.md 创意提示词编排(种子 / brief / 独立批评 / 媒体 / 删减)
  103. motion-craft.md 动效工艺(Emil Kowalski 体系)
  104. motion-review.md 动效专项审查(Before/After/Why + 阻断标准)
  105. animation-vocabulary.md 动效术语词典(把模糊描述转成准确 motion brief)
  106. apple-fluid-interfaces.md Apple 流体交互(手势、弹簧、速度交接、透明材质)
  107. engineering-checklist.md 工程验收(Vercel WIG + 组件行为标准)
  108. carbon-foundations.md Carbon 网格/token/排版/动效/内容/a11y/AI
  109. carbon-components.md Carbon 组件选型矩阵 + 七问 dossier
  110. carbon-patterns.md Carbon 表单/对话/状态/CRUD 完整工作流
  111. carbon-data-visualization.md Carbon 图表选型/轴/颜色/图例/仪表盘
  112. carbon-source-map.md 319 页 sitemap + 321 MDX 覆盖与刷新方法
  113. chinese-typography.md 中文排版与配色(W3C clreq / Ant Design / Apple HIG)
  114. preflight.md 交付前门禁
  115. design-systems/{58 站}/ DESIGN.md 设计系统参考库
  116. ```
  117. ## 实测验证
  118. 规则不是拍脑袋写的。改造前先做了一场受控实验:6 个变体(anthropics/frontend-design、vercel/web-design-guidelines、ui-ux-pro-max、taste-skill、emil-design-eng、无 Skill 对照组)× 7 个任务(落地页/仪表盘/作品集/交互向导/组件面板/创意 404/多样性挑战)= 42 个页面,横评视觉个性、工程规范、动效工艺、交互完成度、组件合理性、创造性、多样性七个维度。
  119. 后续复测扩展为 [8 个变体 × 10 个任务的公开横评](https://designskill.qiaomu.ai/),覆盖电商详情、移动端与数据叙事等新场景。采用的机制与来源记录在对应 `references/` 及下方致谢中。
  120. 这些结果证明的是案例与机制可复查,不等于所有未来输出自动达到同一质量;每个新项目仍要通过自己的功能、构建、浏览器和人工判断。
  121. ## 配置与权限边界
  122. 本 skill 没有必需环境变量。交互预览只在本机回环地址启动临时服务,并会在项目内写入
  123. `design-previews/`;正式实现会修改用户明确放入范围的项目文件。外部参考、媒体生成、付费服务、
  124. K3 或其他模型调用都需要当前任务的明确需求或授权。API key 只放本地受保护环境,不写入提示词、仓库或日志。
  125. ## 限制与边界
  126. - 这是面向 Agent-Skills-compatible 客户端的 Skill,不是独立软件;效果依赖执行代理、项目上下文与验收质量
  127. - 风格试衣间默认生成浅层任务目录:`design-previews/YYYY-MM-DD-任务名/index.html`;
  128. 当前不在项目中时退到桌面目录;用户可以指定输出目录
  129. - 点选回传依赖本地预览服务;服务失败时降级为打开 HTML 文件并在对话中回复选择
  130. - 本 skill 只做设计,不会默认给生成页面注入打赏、公众号、GitHub/X 浮条或乔木个人 Profile;
  131. 对外页面如需署名,建议只放低干扰页脚 `Powered by 向阳乔木` 链接到 `https://qiaomu.ai/`
  132. - 58 站 DESIGN.md 库来自公开网站的设计系统提炼,用于风格参考,不代表对应公司背书
  133. - 装饰性中文字体默认禁用(体积 5-20MB),只在创意标题场景子集化加载——这是特性不是缺陷
  134. ## Troubleshooting
  135. | 问题 | 常见原因 | 解决 |
  136. |---|---|---|
  137. | `No valid skills found` | `SKILL.md` 未安装到客户端扫描路径或 frontmatter 损坏 | 先运行 `npx skills add ... --list`,再确认安装目录里存在根级 `SKILL.md` |
  138. | 预览页能打开但选择没有回传 | 用 `file://` 打开,或本地服务已退出 | 用 `qiaomu-design-preview-server.mjs --file <index.html> --exit-on-select` 重启;静态模式则回到对话回复 A/B/C/D |
  139. | 页面出现重复“选择方向”按钮 | 旧预览 HTML 与服务注入协议冲突 | 更新到最新版,确认每个方向只有一个 `.qmdp-pick-button`,删除旧 `selection.json` 后重开 |
  140. | 中文字体加载慢或排版跳动 | 引入了完整 CJK Webfont | 正文改用系统中文字体栈;装饰标题只请求实际字符子集 |
  141. | 触发后意外调用外部模型 | 旧版偏好或本地规则仍要求 K3 | 更新到 v3.9.0;默认当前代理执行,只有当前任务明确点名 K3 才调用 |
  142. ## 来源与致谢
  143. MIT License。融合机制来源(详见 SKILL.md 血统说明):[anthropics/skills](https://github.com/anthropics/skills) · [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines) · [Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill) · [emilkowalski/skills](https://github.com/emilkowalski/skills) · [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) · [pbakaus/impeccable](https://github.com/pbakaus/impeccable) · [arvindrk/extract-design-system](https://github.com/arvindrk/extract-design-system) · [mattpocock/skills](https://github.com/mattpocock/skills) · [IBM Carbon Design System](https://carbondesignsystem.com/)(官方站点与 Apache-2.0 `carbon-website` 文档的重写摘要) · DESIGN.md 库基于 [VoltAgent/awesome-design-md](https://github.com/VoltAgent/awesome-design-md)(Google Stitch 格式)
  144. <!-- qiaomu-profile:start -->
  145. ## 关于向阳乔木
  146. 向阳乔木(乔向阳 / Joe)是一位实践型 AI 产品与内容创作者,长期把前沿 AI 变化转译成可复用的工作流、产品判断、AI 编程实践、AI 搜索实践和 GEO/AI 营销方法。
  147. - 个人网站: https://qiaomu.ai
  148. - 博客: https://blog.qiaomu.ai
  149. - X: https://x.com/vista8
  150. - GitHub: https://github.com/joeseesun/
  151. - 微信公众号: 向阳乔木推荐看
  152. ### 支持与关注
  153. | 打赏支持 | 微信公众号 |
  154. |---|---|
  155. | <img src="assets/qiaomu-profile/qiaomu_reward_qr.png" alt="向阳乔木打赏二维码" width="180" /> | <img src="assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpg" alt="向阳乔木推荐看公众号二维码" width="180" /> |
  156. | 感谢支持乔木持续分享 AI 实践 | 扫码关注「向阳乔木推荐看」 |
  157. <!-- qiaomu-profile:end -->
  158. ## License / 版权
  159. MIT License。Copyright (c) 向阳乔木。
  160. 项目主页:[qiaomu.ai](https://qiaomu.ai/) · GitHub:[@joeseesun](https://github.com/joeseesun)
  161. ---
  162. <a name="english"></a>
  163. # English
  164. **qiaomu-design** is an Agent Skill that helps AI-generated interfaces avoid default template aesthetics. It combines visual direction, implementation, and browser-based verification in one opinionated workflow.
  165. ## Install
  166. ```bash
  167. npx skills add joeseesun/qiaomu-design
  168. ```
  169. Then ask your Agent-Skills-compatible client: `redesign my landing page and show four visual directions first`.
  170. ## What you get
  171. - **Explicit executor routing**: the current agent implements by default. K3 or any other external model is used only when the user explicitly requests it in the current task.
  172. - **Style fitting room**: 4 mutually-divergent direction mockups (real fonts/colors/layout) in `design-previews/YYYY-MM-DD-task/index.html`. Pick by click or keys, confirm with dial values and optional notes, then the local preview server reports the selection back to the current workflow.
  173. - **Design read + three dials**: VARIANCE / MOTION / DENSITY auto-tuned per task type — restrained on functional UI, bold on open creative briefs.
  174. - **Anti-slop bans**: no AI-purple gradients, no Inter, no italics, no centered-hero clichés, no "revolutionary/seamless" copy.
  175. - **Chinese typography rules**: system font stack first, subset decorative CJK webfonts (5-20 MB otherwise), CJK spacing/punctuation/line-height discipline.
  176. - **Motion craft** (Emil Kowalski system) and **engineering checklist** (Vercel WIG): easing/durations/stagger, a11y, focus traps, destructive-action guards.
  177. - **58 real-site DESIGN.md library** (Stripe, Linear, Apple…, Google Stitch format) for "make it like X" requests.
  178. - **Polish mode** for existing pages (Audit/Critique/Polish/Animate/Harden/Live) — no rewrites from scratch.
  179. - **Pre-flight gate**: a hard checklist; nothing ships if any item fails.
  180. - **Self-evolution**: feedback is recorded as events, abstracted into evidence-backed candidate rules, explicitly approved, published to the preferences ledger, and verified or rolled back when it causes regressions.
  181. ## Verified
  182. The first controlled comparison covered 6 variants × 7 tasks × 42 generated pages; the public follow-up expands to [8 variants × 10 tasks × 80 generated pages](https://designskill.qiaomu.ai/). The screenshots above link to interactive case pages. This evidence applies to those cases and mechanisms; every future project still needs its own tests and visual verification.
  183. ## Limits
  184. Requires an Agent-Skills-compatible client. The fitting room is a local HTML preview served by a tiny local callback server; if the server cannot start, it falls back to a static file and asks the user to reply with the selected direction. qiaomu-design does not inject Qiaomu profile widgets into generated pages by default. The DESIGN.md library is distilled from public sites for reference, not endorsement.
  185. MIT © 向阳乔木 · [qiaomu.ai](https://qiaomu.ai/) · [@joeseesun](https://github.com/joeseesun)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.