nex_design_system/START-HERE.md

1.7 KiB
Raw Permalink Blame History

NEX 0.1.7 — 快速开始

第一步:放置规范

将整个 NEX-Design-System-v0.1.7/ 放到:

project-root/standards/nex-design-system/

第二步:复制配置

复制:

standards/nex-design-system/config/project-profile.example.yaml

到项目根目录并命名为:

nex.config.yaml

默认技术栈已预置。通常只需要在项目类型不是全栈,或你明确要改变默认技术时,覆盖少量字段。

第三步:合并 Agent 入口

不要覆盖项目已有的根 AGENTS.md。将本包 AGENTS.md 中的 NEX 入口段合并进去,并把规范路径调整为实际路径。

第四步:首次接入

  • 新建空项目:把 templates/project-setup-prompt.md 交给 Agent,让它依据配置初始化项目骨架和设计基础。
  • 已有项目:同样使用该提示词,但要求 Agent 识别并保留现有技术栈、Token、组件和 UI 规范,不得迁移技术栈。

首次接入完成后,日常开发不再重复执行完整接入流程。

日常开发

直接向 Agent 描述功能需求。默认规则:

  1. 读取项目根 AGENTS.md、nex.config.yaml 和项目级 UI 规范;
  2. 只读取与当前任务相关的 NEX 章节;
  3. 优先复用现有布局、Token 和组件;
  4. 按项目已有的设计语言实现;
  5. 不擅自升级技术栈、改变业务交互或重做无关页面;
  6. 在对话中说明改了什么,不自动生成阶段报告。

NEX 不接管测试

NEX 不规定测试框架、测试覆盖、浏览器测试流程、屏幕阅读器测试或质量闸门。项目原有工程规范继续负责这些内容。不要因为安装 NEX 而新增 reports/、scripts/ui/ 或其他测试资产。