正在打开每日关注
正在打开每日关注
把抽象设计偏好转成可执行规则,并显式注入 Claude Code 上下文后校验。
很多团队写了 DESIGN.md,接入 Claude Code 后效果还是有限。 通常有两个原因: 1、规则太虚 “现代、极简、高端”对 Agent 没什么可执行性。要改成明确规则:颜色、间距、组件、响应式、无障碍怎么处理。 2、文件没真正接入上下文 DESIGN.md 放在根目录,不代表 Claude Code 会自动读取。 可以在 CLAUDE.md 里显式引入: Follow the design system and UI rules defined in @DESIGN.md. 再用 /context 确认是否加载。 上线前可跑: npx @google/design.md lint DESIGN.md npx @google/design.md diff DESIGN.md DESIGN-v2.md 核心就三件事: 规则写具体、显式接入、上线前校验。
是什么 这是一条面向 Agent 辅助开发团队的实践型观点,讨论为什么团队已有 DESIGN.md,却仍难以显著改善 Claude Code 的产出。作者将问题归因于规则不可执行,以及设计文档没有真正进入 Agent 上下文。
核心设计 它主张把“现代、极简、高端”等审美描述拆解为颜色、间距、组件、响应式和无障碍等可验证约束,再通过 CLAUDE.md 显式引用 DESIGN.md,并用 /context 检查加载结果。最后配合 lint 与 diff,在上线前发现规范缺失或版本变化。
关键洞察 设计系统要对 Agent 有效,不能只承担团队共识文档的角色,还要成为生成、检查和迭代流程中的可读规则源。显式接入也比依赖目录位置或隐式发现更可靠,这种方法能减少重复提示,提升界面一致性与评审效率。
边界与风险 原文没有展示命令实际输出,也无法确认外链文章内容,因此工具能力和 Claude Code 的具体加载行为应以实际环境为准。lint 只能检查结构化规则,无法替代真实页面的视觉、交互、可用性与无障碍验收。