@routerhub/agent-rules 1.5.20 → 1.5.22
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 +15 -0
- package/CHANGELOG.md +7 -1
- package/package.json +1 -1
package/AGENTS.base.md
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
## 语言与内容
|
|
6
6
|
|
|
7
7
|
- 始终使用中文回答，代码注释使用中文，每行代码配中文注释。
|
|
8
|
+
- 我是测试用的。
|
|
8
9
|
- 页面 UI 内容（按钮、字段名、提示等）全部英文；如需中文在 `AGENTS.private.md` 中声明。
|
|
9
10
|
- 仅修改网站协议、条款、页面文案等文本内容时，必须保留原有结构、格式、样式和布局，只替换文字；只有用户明确要求调整样式时，才允许同步修改样式。
|
|
10
11
|
|
|
@@ -104,6 +105,7 @@ Closes #456
|
|
|
104
105
|
- 所有新建文档必须使用 HTML 格式（`.html`），禁止使用 Markdown（`.md`）格式。
|
|
105
106
|
- 已有的 `.md` 文件可保留，但新增文档一律使用 HTML。
|
|
106
107
|
- 编写 HTML 文档时，文档标题、正文、章节、说明文字、图注、表格等内容必须使用中文；仅代码、命令、专有名词、接口字段或页面 UI 原文可保留英文。
|
|
108
|
+
- 编写 HTML 文档时，核心内容必须优先用截图、图片、流程图、对比图、标注图等可视化形式表达；图片内需添加箭头、圈选和简短中文标注，尽量减少英文字段和长段文字，能用可视化表达的内容不得只用文字说明。
|
|
107
109
|
- 编写 HTML 文档时，所有图片资源（包括截图、图表、插图等）必须以 base64 data URI 形式内嵌到 HTML 中，禁止引用或额外输出独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件，确保他人只打开 HTML 文件即可看到全部内容并用于发版。
|
|
108
110
|
|
|
109
111
|
## 新需求与回归测试准入
|
|
@@ -120,6 +122,13 @@ Closes #456
|
|
|
120
122
|
- 用户暂不安装或当前环境无法安装时，不得因此中断任务；必须按本规则中的等价流程继续执行，包括需求文档、实现计划、测试准入、代码实现和完成前验证。
|
|
121
123
|
- 不得把某一台电脑已安装 Superpowers 当作团队默认事实；交付说明中应明确本次是使用 Superpowers 流程，还是按 AGENTS 规则执行了等价流程。
|
|
122
124
|
|
|
125
|
+
## 新需求与回归测试准入
|
|
126
|
+
|
|
127
|
+
- 每个新需求必须同步新增或更新可自动化回归用例；仅纯文案、纯文档或无可自动化行为的改动可例外，但交付时必须说明无需新增用例的原因与人工验证方式。
|
|
128
|
+
- 新增或更新的测试用例必须接入项目回归测试中心的可运行范围：用户明确说明当前版本号或版本名称时，归档到对应版本测试范围；用户未说明版本时，归档到全量测试，确保“全量测试”会执行或展示该用例。
|
|
129
|
+
- 使用 Superpowers 或其他代理流程处理需求时，测试设计是交付的一部分；需求文档、实现计划、代码改动与测试接入必须同步考虑，禁止只完成业务代码而遗漏全量或版本回归用例。
|
|
130
|
+
- 交付说明必须列出新增或更新的测试用例名称、所在文件、归属范围（版本或全量）以及已执行的测试命令与结果。
|
|
131
|
+
|
|
123
132
|
## 优先级
|
|
124
133
|
|
|
125
134
|
1. 项目私有规则（AGENTS.private.md）
|
|
@@ -131,6 +140,12 @@ Closes #456
|
|
|
131
140
|
- 截图结果必须包含当前页面 URL（地址栏可见或在截图说明中明确写出完整 URL）。
|
|
132
141
|
- 在截图上添加箭头、标注、提示文字等注释时，必须放在页面空白区域，不得覆盖页面原有内容（文字、按钮、表格数据等）。
|
|
133
142
|
|
|
143
|
+
## 可视化汇报
|
|
144
|
+
|
|
145
|
+
- 完成任务后的汇报优先提供可视化结果，能打开页面时就直接在集成浏览器中打开，并定位到相关区域后再汇报。
|
|
146
|
+
- 涉及配置、官网或其他系统联动时，需同时打开所有相关页面，并按实际操作路径展示联动结果，方便直接验证。
|
|
147
|
+
- 若客观上无法可视化展示，需说明原因，并补充截图、录屏、日志或请求响应作为替代证据。
|
|
148
|
+
|
|
134
149
|
<!-- @domain: frontend -->
|
|
135
150
|
|
|
136
151
|
## Figma 还原规范
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
所有对 @routerhub/agent-rules 的重大更改都会记录在这个文件中。
|
|
4
4
|
|
|
5
|
+
## [1.5.21] - 2026-06-10
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- 新增可视化汇报规则：完成任务后的汇报优先在集成浏览器中打开相关页面并定位到关键位置；涉及配置、官网或其他系统联动时需同时打开所有相关页面，方便直接验证联动结果。
|
|
10
|
+
- 新增 HTML 文档可视化表达规则：核心内容必须优先通过截图、图片、流程图、对比图和标注图展示，并在图片内添加箭头、圈选和简短中文标注，尽量减少英文字段和长段文字。
|
|
11
|
+
|
|
5
12
|
## [1.5.20] - 2026-06-09
|
|
6
13
|
|
|
7
14
|
### Added
|
|
@@ -43,7 +50,6 @@
|
|
|
43
50
|
### Changed
|
|
44
51
|
|
|
45
52
|
- 强化 HTML 文档图片规则，要求所有图片资源以 base64 data URI 内嵌，确保单个 HTML 文件即可完整查看并用于发版。
|
|
46
|
-
|
|
47
53
|
## [1.5.13] - 2026-06-03
|
|
48
54
|
|
|
49
55
|
### Added
|