1.4 KiB
1.4 KiB
11. Project Adoption
1. 新项目
- 读取
nex.config.yaml; - 按默认 stack 和
project.type初始化技术骨架; - 建立一份项目级 UI 规范,明确品牌方向、主题、布局/导航、组件使用约定、关键页面模式和特殊交互;
- 先复用 NEX 的通用原则,不要为项目创建重复的 NEX 组件包;
- 普通开发直接按 Agent 轻量流程推进。
2. 已有项目
- 识别当前技术栈、项目 UI 规范、主题/Token 来源和共享组件;
- 保留已验证成熟的设计和交互;
- 将项目差异视为项目适配,不机械迁移到 NEX 示例;
- 仅记录会影响后续开发的关键差异,不做大规模审计报告;
- 用户明确提出全局规范整理时,才制定单独计划。
3. 符合性映射(可选)
如果需要记录项目与 NEX 的关系,可在一份现有 UI 规范中加入简短映射:
- ADOPTED:直接采用 NEX 原则;
- ADAPTED:采用项目成熟实现;
- DEFERRED:暂不处理;
- NOT_APPLICABLE:项目不存在此类场景。
不要求每个新项目生成完整矩阵或长期维护逐条审计台账。
4. 冲突
NEX 原则与项目视觉选择冲突时,优先保留合理的项目设计;NEX 对一致性、组件复用、语义清晰和可用性的约束仍然适用。涉及用户目标不明确的产品决策时,提出一个关键问题,不要自行扩展范围。