「做一个无障碍的表单」几乎得不到稳定结果;「每个控件有关联 label、错误用 aria-describedby 关联、聚焦顺序与 DOM 一致」则会明显不同。约束的粒度决定产出的可用性。

01把标准写成可判定的句子

避免形容词,改用可检查的条款:目标 WCAG 版本与级别、标题层级与 landmark、每个控件的名称来源、键盘操作方式、焦点可见与归还规则、状态如何用 ARIA 表达、对比度阈值、reduced-motion 与 forced-colors 行为。每一条都对应一个能回答「是/否」的检查,生成结果才能被验证,而不是靠感觉判断「挺规范的」。

团队协作时,「提示词约束」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

02给结构、给示例、给反例

提供一段团队认可的最小正确示例,以及一个常见错误写法(例如 placeholder 代替 label),并说明为什么错;指定允许复用的组件与设计令牌清单,限制自由发挥的范围;对交互复杂的部件,要求先输出 DOM 结构与状态说明,再写样式。这样模型是在既有约定内补全,而不是重新发明一套界面语言。

团队协作时,「提示词约束」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

03把约束放到离代码最近的地方

提示词会过期,仓库里的规则不会。把同样的条款写进组件文档、lint 规则、CI 检查与 PR 模板,让生成代码无论来自谁都经过同一道门。定期用真实缺陷回补条款:每发现一类重复问题,就新增一条可判定的约束。久而久之,提示词、规范与测试用例会收敛成同一份东西。

团队协作时,「提示词约束」最好有一个明确的负责人和一份最短示例。示例要能直接复制运行,包含正确写法与一个典型的错误写法,让新成员在十分钟内建立直觉,比长篇规范文档有效得多。

要点速览

  • 用可判定的条款替代「无障碍」「好用」等形容词
  • 明确 WCAG 版本、名称来源、键盘与焦点、状态表达、对比度
  • 提供正确示例、典型反例与允许复用的组件清单
  • 把约束同步固化到 lint、CI 与 PR 模板,持续回补

你写不清验收标准,就很难怪产出不符合标准。