1.9 KiB
1.9 KiB
00. NEX Governance & Scope
1. NEX 的唯一职责
NEX 只负责两件事:
- 统一软件产品的设计规范;
- 约束 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默认值;已有项目以实际代码和锁文件为准。