跳到主要内容

规则与规范文档

设计类 AI 协作最怕“只有画面,没有规则”。如果组件状态、token 命名、交互动线和可访问性标准没有写进稳定文档,模型每次都会重新猜视觉和行为。

设计侧文档分层

载体应该承载什么
AGENTS.md设计系统合同、token 命名、组件状态与验收要求
工具说明 / CLAUDE.md设计协作习惯、输出格式、命名偏好
标注文档 / Figma 注释节点层级、状态、断点和交互说明
handoff 模板给前端和测试的资产清单、风险和限制

最有价值的设计长期规则

  • 所有组件必须列出状态和变体。
  • 颜色、间距、字号必须有 token 命名规则。
  • 可访问性要求必须显式写在组件或页面规范里。
  • handoff 不能只给截图,必须给节点、标注和限制说明。

可直接复制的设计模板

模板什么时候先用
Figma Handoff 包模板需要把节点、资产和限制交给前端或 QA 时
组件状态合同模板需要固定状态、变体和异常路径时
Token 与约束模板需要沉淀 token、命名和可访问性约束时
原型验证与证据模板需要记录交互验证、截图和录屏时

这几份模板的入口在 设计训练包模板

下一步