2.8 KiB
2.8 KiB
09. Agent Development Rules
1. 默认工作方式:轻量开发
每个日常任务只做必要的理解和修改:
- 阅读项目根
AGENTS.md、nex.config.yaml和项目 UI 规范; - 按任务读取相关 NEX 章节;
- 找到已有页面模式、Token 和共享组件;
- 在明确范围内实现需求;
- 在对话中简要说明改动。
不得把每个功能任务都转化为全项目审计、分阶段专项或规范升级。
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编写测试计划和测试报告。