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