nex_design_system/docs/00-governance.md

1.9 KiB
Raw Permalink Blame History

00. NEX Governance & Scope

1. NEX 的唯一职责

NEX 只负责两件事:

  1. 统一软件产品的设计规范;
  2. 约束 AI Agent 按照明确的技术栈、设计规范和项目既有资产开展开发。

NEX 不是测试框架、QA 体系、CI 平台或项目审计产品。

2. NEX 覆盖范围

  • 设计原则与视觉语言;
  • Design Tokens 与主题;
  • 布局、导航与响应式界面设计;
  • 组件复用与组件契约;
  • 页面模式;
  • 用户交互与状态反馈;
  • 无障碍设计要求;
  • 面向用户体验的性能设计原则;
  • 默认技术栈与 Agent 开发约束。

3. 明确不覆盖

  • 单元、集成、端到端测试及覆盖率;
  • 测试框架、浏览器自动化和测试执行频率;
  • 屏幕阅读器测试流程、平台矩阵和测试记录;
  • CI/CD、lint/test 质量闸门、发布验收;
  • 测试证据、截图归档和阶段报告;
  • 自定义测试/审计脚本的建立和维护。

项目原有的测试体系继续按项目自身要求执行,NEX 不增补、不接管、不扩展。

4. 三层规范模型

层级 内容 决定什么
L1 NEX Core 跨项目设计和 Agent 开发约束 设计原则、复用、实现纪律
L2 Project Design Specification 项目专属规范 品牌、具体视觉、尺寸、断点、组件、业务交互
L3 Project Implementation 实际代码 Token、主题、组件和页面实现

5. 冲突处理

  • 用户当前明确要求优先于通用示例。
  • 项目级 UI 规范决定项目具体视觉和交互。
  • NEX Core 规定跨项目原则,不强制套用其他项目的像素数值、颜色、Token 前缀或组件命名。
  • 已验证成熟的项目实现优先保留;发现冲突时先判断其是否为合理适配。
  • 新项目技术栈按 nex.config.yaml 默认值;已有项目以实际代码和锁文件为准。