54 lines
2.8 KiB
Markdown
54 lines
2.8 KiB
Markdown
# 09. Agent Development Rules
|
||
|
||
## 1. 默认工作方式:轻量开发
|
||
|
||
每个日常任务只做必要的理解和修改:
|
||
1. 阅读项目根 `AGENTS.md`、`nex.config.yaml` 和项目 UI 规范;
|
||
2. 按任务读取相关 NEX 章节;
|
||
3. 找到已有页面模式、Token 和共享组件;
|
||
4. 在明确范围内实现需求;
|
||
5. 在对话中简要说明改动。
|
||
|
||
不得把每个功能任务都转化为全项目审计、分阶段专项或规范升级。
|
||
|
||
## 2. 规范加载
|
||
|
||
- 始终读取:本文件、项目根 Agent 指令、项目配置和项目 UI 规范。
|
||
- 视觉原则:按需读 `01`;Token/主题:读 `02`;布局/响应式:读 `03`;组件:读 `04`;交互:读 `05`;无障碍:读 `06`;体验性能:读 `07`;页面模式:读 `08`;技术栈:新项目/技术初始化时读 `10`。
|
||
- 不得默认读取全部 NEX 文档。
|
||
|
||
## 3. 先复用再实现
|
||
|
||
先查看现有布局、组件、Token、主题和相邻页面。已有实现能满足需求时不重复建设。仅当重复模式稳定且有实际复用价值时才抽象共享组件。
|
||
|
||
## 4. 变更范围
|
||
|
||
- 只修改完成当前任务所需的代码和文档。
|
||
- 不顺手整理无关 CSS、重命名组件或重构其他页面。
|
||
- 不因 NEX 示例而更换颜色、尺寸、断点、组件库或目录结构。
|
||
- 不擅自改业务流程、数据语义和用户操作路径。
|
||
- 涉及全局 Token、应用 Shell、共享组件契约或大范围视觉语言变更时,先用简短说明告知影响范围,再实施。
|
||
|
||
## 5. 技术栈约束
|
||
|
||
- 新项目按 `nex.config.yaml` 的默认 `stack` 创建。
|
||
- 已有项目以真实代码和锁文件为准,保留现有技术栈。
|
||
- 不擅自升级框架、替换 UI 库、迁移 JavaScript/TypeScript 或改变数据库。
|
||
|
||
## 6. 文档与辅助文件约束
|
||
|
||
- 普通任务结果在对话中汇报,不自动创建 Markdown 报告。
|
||
- 不创建阶段编号报告、`reports/` 目录或证据截图目录。
|
||
- 不创建 NEX 专属测试脚本、`scripts/ui/` 或额外检查工具。
|
||
- 不为 NEX 引入测试依赖或测试框架。
|
||
- 不复制整套 NEX 文档到项目 `docs/` 形成重复规范。
|
||
- 长期有效的项目设计决策应更新已有 UI 规范;确需新增文件时,先确认没有合适的现有文档。
|
||
|
||
## 7. 任务说明与完成汇报
|
||
|
||
普通任务不要求先提交长计划。复杂变更用简短文字说明:改哪些区域、复用哪些组件、主要设计选择。完成后用对话汇报:改动摘要、主要文件、重要设计决定和未解决阻塞。不自动生成长报告。
|
||
|
||
## 8. NEX 不定义测试流程
|
||
|
||
是否运行项目测试、使用什么工具、覆盖哪些场景,由用户指令和项目自身工程规则决定。NEX 不要求 Agent 每次运行测试、浏览器自动化、读屏器或全站视觉回归;也不要求 Agent编写测试计划和测试报告。
|