@routerhub/agent-rules 1.5.18 → 1.5.20

package/AGENTS.base.md

@@ -106,6 +106,20 @@ Closes #456
 - 编写 HTML 文档时，文档标题、正文、章节、说明文字、图注、表格等内容必须使用中文；仅代码、命令、专有名词、接口字段或页面 UI 原文可保留英文。
 - 编写 HTML 文档时，所有图片资源（包括截图、图表、插图等）必须以 base64 data URI 形式内嵌到 HTML 中，禁止引用或额外输出独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件，确保他人只打开 HTML 文件即可看到全部内容并用于发版。
 
+## 新需求与回归测试准入
+
+- 每个新需求必须同步新增或更新可自动化回归用例；仅纯文案、纯文档或无可自动化行为的改动可例外，但交付时必须说明无需新增用例的原因与人工验证方式。
+- 新增或更新的测试用例必须接入项目回归测试中心的可运行范围：用户明确说明当前版本号或版本名称时，归档到对应版本测试范围；用户未说明版本时，归档到全量测试，确保“全量测试”会执行或展示该用例。
+- 使用 Superpowers 或其他代理流程处理需求时，测试设计是交付的一部分；需求文档、实现计划、代码改动与测试接入必须同步考虑，禁止只完成业务代码而遗漏全量或版本回归用例。
+- 交付说明必须列出新增或更新的测试用例名称、所在文件、归属范围（版本或全量）以及已执行的测试命令与结果。
+
+## Superpowers 安装与缺失处理
+
+- 团队统一推荐使用 Superpowers 插件或同等技能流程处理新需求、调试、计划、测试驱动开发和完成前验证。
+- 代理或开发者进入项目后，如果当前环境无法使用 Superpowers，应先提示用户安装或启用 Superpowers；当前代理支持插件安装工具时，应优先发起安装建议，当前代理不支持时，应给出清晰的手动安装说明。
+- 用户暂不安装或当前环境无法安装时，不得因此中断任务；必须按本规则中的等价流程继续执行，包括需求文档、实现计划、测试准入、代码实现和完成前验证。
+- 不得把某一台电脑已安装 Superpowers 当作团队默认事实；交付说明中应明确本次是使用 Superpowers 流程，还是按 AGENTS 规则执行了等价流程。
+
 ## 优先级
 
 1. 项目私有规则（AGENTS.private.md）

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 所有对 @routerhub/agent-rules 的重大更改都会记录在这个文件中。
 
+## [1.5.20] - 2026-06-09
+
+### Added
+
+- 新增 Superpowers 安装与缺失处理规则：当前环境无法使用 Superpowers 时，代理需先提示安装或启用；无法安装时必须按 AGENTS 等价流程继续执行，并在交付说明中明确使用的流程。
+
+## [1.5.19] - 2026-06-09
+
+### Added
+
+- 新增新需求回归测试准入规则：每个新需求必须同步新增或更新自动化回归用例；用户指定版本时归档到对应版本测试范围，未指定版本时归档到全量测试，并在交付说明中列出用例名称、文件、归属范围和执行结果。
+
 ## [1.5.18] - 2026-06-09
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.18",
+  "version": "1.5.20",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {