@routerhub/agent-rules 1.5.61 → 1.5.64
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.base.md +7 -0
- package/package.json +1 -1
- package/rules/global.md +7 -0
package/AGENTS.base.md
CHANGED
|
@@ -14,6 +14,12 @@
|
|
|
14
14
|
- 页面 UI 内容（按钮、字段名、提示等）全部英文；如需中文在 `AGENTS.private.md` 中声明。
|
|
15
15
|
- 仅修改网站协议、条款、页面文案等文本内容时，必须保留原有结构、格式、样式和布局，只替换文字；只有用户明确要求调整样式时，才允许同步修改样式。
|
|
16
16
|
|
|
17
|
+
## 需求实现原则
|
|
18
|
+
|
|
19
|
+
- ⚠️ **严格按用户原话实现需求，禁止擅自添加用户未要求的限制、规则或约束。** 例如用户说"展示一个轮播图"，就只实现轮播图功能，不得自行添加"最多 6 个元素"、"必须自动播放"等用户没提的限制。
|
|
20
|
+
- 只有代码安全/性能的硬性必要（如防止无限循环、防止内存泄漏、防止 XSS 等）才允许添加隐含约束，且必须在实现时向用户说明添加原因。
|
|
21
|
+
- 不确定某个限制或规则是否必要时，必须先询问用户，禁止直接添加。
|
|
22
|
+
|
|
17
23
|
## Git 规范
|
|
18
24
|
|
|
19
25
|
- 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。
|
|
@@ -135,6 +141,7 @@ Closes #456
|
|
|
135
141
|
- 编写 HTML 文档时，所有图片资源（包括截图、图表、插图等）必须以 base64 data URI 形式内嵌到 HTML 中，禁止引用或额外输出独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件，确保他人只打开 HTML 文件即可看到全部内容并用于发版。
|
|
136
142
|
- 所有新建 HTML 文档的文件名必须使用中文命名（如 `用户登录流程说明.html`），禁止使用英文或拼音文件名，方便团队成员一眼识别文档内容。
|
|
137
143
|
- 所有新建 HTML 文档必须统一存放到项目根目录的 `docs/` 文件夹下，禁止散落在桌面、下载目录、临时目录或其他任意位置。如该文件夹不存在则先创建。
|
|
144
|
+
- ⚠️ **编写 HTML 报告/文档时，每一段说明文字必须与其对应的截图、图片紧挨着放在一起（同一视觉区域内）**，禁止将说明文字集中放在页面顶部、图片全部堆在底部，导致读者需要上下翻页才能对照阅读。正确做法：每写完一段说明文字后，紧接着就放该段说明对应的图片，形成"说明 → 配图"的紧密组合，然后再写下一段说明和下一张图。
|
|
138
145
|
|
|
139
146
|
## 新需求与回归测试准入
|
|
140
147
|
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -14,6 +14,12 @@ name: "通用规则"
|
|
|
14
14
|
- 页面 UI 内容（按钮、字段名、提示等）全部英文；如需中文在 `AGENTS.private.md` 中声明。
|
|
15
15
|
- 仅修改网站协议、条款、页面文案等文本内容时，必须保留原有结构、格式、样式和布局，只替换文字；只有用户明确要求调整样式时，才允许同步修改样式。
|
|
16
16
|
|
|
17
|
+
## 需求实现原则
|
|
18
|
+
|
|
19
|
+
- ⚠️ **严格按用户原话实现需求，禁止擅自添加用户未要求的限制、规则或约束。** 例如用户说"展示一个轮播图"，就只实现轮播图功能，不得自行添加"最多 6 个元素"、"必须自动播放"等用户没提的限制。
|
|
20
|
+
- 只有代码安全/性能的硬性必要（如防止无限循环、防止内存泄漏、防止 XSS 等）才允许添加隐含约束，且必须在实现时向用户说明添加原因。
|
|
21
|
+
- 不确定某个限制或规则是否必要时，必须先询问用户，禁止直接添加。
|
|
22
|
+
|
|
17
23
|
## Git 规范
|
|
18
24
|
|
|
19
25
|
- 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。
|
|
@@ -135,6 +141,7 @@ Closes #456
|
|
|
135
141
|
- 编写 HTML 文档时，所有图片资源（包括截图、图表、插图等）必须以 base64 data URI 形式内嵌到 HTML 中，禁止引用或额外输出独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件，确保他人只打开 HTML 文件即可看到全部内容并用于发版。
|
|
136
142
|
- 所有新建 HTML 文档的文件名必须使用中文命名（如 `用户登录流程说明.html`），禁止使用英文或拼音文件名，方便团队成员一眼识别文档内容。
|
|
137
143
|
- 所有新建 HTML 文档必须统一存放到项目根目录的 `docs/` 文件夹下，禁止散落在桌面、下载目录、临时目录或其他任意位置。如该文件夹不存在则先创建。
|
|
144
|
+
- ⚠️ **编写 HTML 报告/文档时，每一段说明文字必须与其对应的截图、图片紧挨着放在一起（同一视觉区域内）**，禁止将说明文字集中放在页面顶部、图片全部堆在底部，导致读者需要上下翻页才能对照阅读。正确做法：每写完一段说明文字后，紧接着就放该段说明对应的图片，形成"说明 → 配图"的紧密组合，然后再写下一段说明和下一张图。
|
|
138
145
|
|
|
139
146
|
## 新需求与回归测试准入
|
|
140
147
|
|