进阶 impeccable.style 2026-11-22 15:26:07 · 2 阅读

第9章 Agent 缺失的设计词汇表——用 document 记录视觉系统

记录你的视觉系统,以便后续工作能够遵循。

本页包含 3 个部分

大多数 Agent 使用 /impeccable。在 Codex 中,请使用 $impeccable。

当你的项目有想要保持的视觉风格时,使用 document。Impeccable 会读取现有界面,并将其颜色、排版、布局和组件规则记录在 DESIGN.md 中。

在设计成型后、旧记录过时或重新设计之前运行它,以捕捉当前的状态。

尝试

/impeccable document

如果 DESIGN.md 已存在,Impeccable 会显示它,并在覆盖前询问你希望如何更新。

工作原理

  • 发现系统:在浏览器可用时,检查 token、样式、组件及渲染页面。
  • 解释选择:确认设计的特征以及颜色、字体和组件的预期作用。
  • 编写记录:以结构化形式列出可重用的值,并以可读的文本解释如何使用它们。
  • 准备设计面板:生成 Live Mode 使用的额外元数据和组件预览。

在界面中

你通常的顺序:在下订单前检查数量和交付细节。

检查订单

在 DESIGN.md 中

colors.action: "#263c32"

主操作使用深绿色主要按钮。保持次要操作低调。

保留按钮的焦点轮廓以便键盘使用。

示例摘录:记录将可重用值与其用法关联起来。Document 捕捉既定的选择;请审查它,以免意外变成规则。

常规扫描会生成两个文件。DESIGN.md 存储视觉系统及其设计 token:颜色、间距等事物的命名值。.impeccable/design.json 添加 Markdown 格式无法容纳的元数据和组件预览。你不需要手动编辑那个生成的文件。

DESIGN.md 格式是什么?

该文件遵循 DESIGN.md 格式。其 YAML frontmatter 存储 token 值;其 Markdown 解释其用途。

正文支持八个按顺序排列的部分:Overview、Colors、Typography、Layout、Elevation & Depth、Shapes、Components 以及 Do’s and Don’ts。可以省略不相关的部分。编辑时请保留生成的标题,以便工具能够识别它们。

额外的元数据,例如动效设置和完整的组件预览,放在 .impeccable/design.json 中。Token 值仍保留在 DESIGN.md 中。

还没有视觉系统?从一个种子开始。

/impeccable document --seed

种子模式帮助你在实现前选择视觉方向。它需要产品背景和第一个要设计的表面,然后引导你完成方向工作坊。如果你在本次会话中已经选择了方向,它会复用该选择。

结果是一个明确标记的起始记录,未解决的实现细节留待后续。它不会发明一个完整的 token 库,也不会生成额外的元数据文件。在有代码可捕捉实际系统后,再次运行 document。

现有的、连贯的界面应在常规扫描模式下进行文档化。如果你想替换其视觉标识,请明确要求重新设计。

检查结果

将记录与界面对比。颜色和字体是否正确?组件规则是否描述了有意的模式?移除来自一次性屏幕的规则,并纠正不再反映设计的内容。

如果重复的样式也需要变成共享代码,请使用 extract。Document 记录系统;extract 整合其实现。

评论 (0)