7.6
深览指数
科技人人都是产品经理·阿基拉de_Akir··AI 生成
YAML契约格式：理解了语义规范体系后怎么写语义规则
本文提供了写 YAML 语义契约的完整操作指南。作者提出，传统设计规范面向人，机器无法直接消费，AI 生成内容时不受语义约束。解法是将设计意图形式化为 Schema-As-Code 的 YAML 契约，在生成前预置边界与规则。文章以错误状态分级（ERR-001）为例，逐字段拆解了 intent_id、description、version、semantic_tokens、immutable_boundaries、llm_constraints 等核心字段的写法与设计原则，并附有常见错误对比和写作检查清单。适合参与 AI 生成界面设计或前端工程化的设计师、产品经理、AI 应用开发者阅读。原文 ↗
核心观点
- ▍传统设计规范面向人，机器无法消费，AI 生成内容时不受语义约束。Schema-As-Code 的解法是将设计意图形式化为 YAML 语义契约，在生成前预置边界与规则。
- ▍YAML 契约的核心是 semantic_tokens 字段，它定义了场景下的语义级别以及每个级别映射的视觉、文案和行动，而非传统的色值或文案。
- 01intent_id 应采用结构化编号（如 ERR-001），而非自然语言命名，以实现精确引用和版本管理。
- 02description 应包含问题现象、根因和后果三要素，如“错误状态后果差异未分级，系统无法区分致命错误、网络抖动、限流提示和降级错误，导致用户无法判断后果严重程度”。
- 03semantic_tokens 中的每个级别（如 fatal、transient）需要定义 visual_mapping（使用 color_token 等语义令牌而非写死色值）、user_action（与后果严重程度匹配）和 llm_constraints（每条可被机器校验）。
- 04immutable_boundaries 定义不可突破的红线，违反时系统直接阻断，如“禁止将 fatal 错误显示为静态灰色”；与 semantic_tokens 的区别在于它是全局安全/合规约束，而非某级别的映射。
- 05llm_constraints 是给 AI 的强制指令，例如“禁止仅显示‘出错了’等模糊文案”，每条约束都必须是可被机器校验的明确规则。
- 06全流程示例：ERR-001 契约定义了 fatal（致命错误，红色脉冲，刷新/导出）、transient（网络抖动，中性，等待/重试）、retryable（限流，警告，等待倒计时/升级）、degraded（部分可用，信息，继续/简化重试）四级错误状态。
反方 / 局限
- — 文章未明确讨论 YAML 契约在大型团队中维护的版本冲突、多人协作时的合并冲突等工程化挑战。
YAMLSchema-As-Codesemantic_tokensimmutable_boundariesllm_constraintsERR-001ChatGPT文心一言通义千问Kimi豆包DeepSeekClaude阿基拉de_Akir
23 分钟 · 4 卡片 · 5 资料
读原文 →