@routerhub/agent-rules 1.5.108 → 1.5.110
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 +4 -0
- package/package.json +1 -1
- package/rules/global.md +4 -0
- package/skills/create-doc/SKILL.md +10 -0
package/AGENTS.base.md
CHANGED
|
@@ -214,6 +214,9 @@
|
|
|
214
214
|
## 部署规则
|
|
215
215
|
|
|
216
216
|
- 发版统一执行 `./release.sh`。
|
|
217
|
+
- ⚠️ **部署流程必须自包含、可直接使用**：开发过程中涉及的任何环境准备工作（数据迁移、建表、字段变更、初始化数据、配置下发等），都必须内嵌到部署流程中自动完成。部署到测试环境 / 生产环境后，功能应直接可用，**不依赖任何人记得在部署前后手动补做步骤**。
|
|
218
|
+
- ⚠️ **发现「需要手动补做的步骤」= 部署流程有缺口**：若某次部署发现还需要人工执行迁移、导数据、改配置等额外步骤功能才能用，说明该步骤未被自动化——应把它纳入部署流程，而不是继续靠记性每次手动补。**人为手动步骤是上线遗漏的根源**（测试环境做了、生产环境容易忘）。
|
|
219
|
+
- ⚠️ **「部署可用」≠「功能已验证」**：部署自动化到位只保证环境就绪、功能直接可操作；功能是否正确，仍需按既有验证铁律用真实数据验证，两者不冲突。
|
|
217
220
|
- ⚠️ 部署测试环境必须使用 `/deploy-test` skill。任何包含「部署测试」「发布测试」「上线测试」「部署test」「推到test」「部署到测试环境」等表述的需求，必须先调用 `Skill` 工具加载 `deploy-test`，严禁跳过 skill 直接执行部署操作。
|
|
218
221
|
- ⚠️ 部署测试环境的正确流程是：当前分支 → 合并到 test 分支 → 推送 test → 触发部署 → 切回原分支。禁止直接在 test 分支上提交代码，禁止跳过合并步骤直接部署功能分支。
|
|
219
222
|
|
|
@@ -227,6 +230,7 @@
|
|
|
227
230
|
|
|
228
231
|
- 新建文档使用 HTML 格式（`.html`）、中文文件名，存到 `docs/` 目录。
|
|
229
232
|
- 使用 `/create-doc` skill 生成符合规范的 HTML 文档。
|
|
233
|
+
- ⚠️ **需求/方案/操作过程类文档必须按步骤逐段记录并详细说明**：文档按操作步骤逐段组织，每一步包含三要素——① 做了什么动作（点了什么按钮/执行了什么命令/打开了什么页面）② 该步骤对应的界面截图，带箭头/红框/提示文字标注指向关键操作点或关键数据（标注放空白区，不遮挡内容）③ 详细说明这一步的结果与验证点。禁止跳过步骤、禁止只贴截图不给说明、禁止用一句套话覆盖所有步骤的截图。图片一律 base64 内嵌。
|
|
230
234
|
|
|
231
235
|
## Figma 还原
|
|
232
236
|
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -214,6 +214,9 @@ name: "通用规则"
|
|
|
214
214
|
## 部署规则
|
|
215
215
|
|
|
216
216
|
- 发版统一执行 `./release.sh`。
|
|
217
|
+
- ⚠️ **部署流程必须自包含、可直接使用**：开发过程中涉及的任何环境准备工作（数据迁移、建表、字段变更、初始化数据、配置下发等），都必须内嵌到部署流程中自动完成。部署到测试环境 / 生产环境后，功能应直接可用，**不依赖任何人记得在部署前后手动补做步骤**。
|
|
218
|
+
- ⚠️ **发现「需要手动补做的步骤」= 部署流程有缺口**：若某次部署发现还需要人工执行迁移、导数据、改配置等额外步骤功能才能用，说明该步骤未被自动化——应把它纳入部署流程，而不是继续靠记性每次手动补。**人为手动步骤是上线遗漏的根源**（测试环境做了、生产环境容易忘）。
|
|
219
|
+
- ⚠️ **「部署可用」≠「功能已验证」**：部署自动化到位只保证环境就绪、功能直接可操作；功能是否正确，仍需按既有验证铁律用真实数据验证，两者不冲突。
|
|
217
220
|
- ⚠️ 部署测试环境必须使用 `/deploy-test` skill。任何包含「部署测试」「发布测试」「上线测试」「部署test」「推到test」「部署到测试环境」等表述的需求，必须先调用 `Skill` 工具加载 `deploy-test`，严禁跳过 skill 直接执行部署操作。
|
|
218
221
|
- ⚠️ 部署测试环境的正确流程是：当前分支 → 合并到 test 分支 → 推送 test → 触发部署 → 切回原分支。禁止直接在 test 分支上提交代码，禁止跳过合并步骤直接部署功能分支。
|
|
219
222
|
|
|
@@ -227,6 +230,7 @@ name: "通用规则"
|
|
|
227
230
|
|
|
228
231
|
- 新建文档使用 HTML 格式（`.html`）、中文文件名，存到 `docs/` 目录。
|
|
229
232
|
- 使用 `/create-doc` skill 生成符合规范的 HTML 文档。
|
|
233
|
+
- ⚠️ **需求/方案/操作过程类文档必须按步骤逐段记录并详细说明**：文档按操作步骤逐段组织，每一步包含三要素——① 做了什么动作（点了什么按钮/执行了什么命令/打开了什么页面）② 该步骤对应的界面截图，带箭头/红框/提示文字标注指向关键操作点或关键数据（标注放空白区，不遮挡内容）③ 详细说明这一步的结果与验证点。禁止跳过步骤、禁止只贴截图不给说明、禁止用一句套话覆盖所有步骤的截图。图片一律 base64 内嵌。
|
|
230
234
|
|
|
231
235
|
## Figma 还原
|
|
232
236
|
|
|
@@ -68,3 +68,13 @@ description: >-
|
|
|
68
68
|
- 截图结果必须包含当前页面 URL
|
|
69
69
|
- 标注（箭头、提示文字等）放在页面空白区域，不覆盖页面内容
|
|
70
70
|
- 制作过程中产生的中间截图文件统一放到 `screenshots/` 目录
|
|
71
|
+
|
|
72
|
+
### 分步操作记录（每步必录）
|
|
73
|
+
|
|
74
|
+
- ⚠️ 需求、方案、操作过程类文档必须按操作步骤逐段组织，每个步骤独立成段，禁止跳过任何步骤、禁止只贴图不给说明、禁止只写文字不放截图
|
|
75
|
+
- ⚠️ 每个步骤必须包含三要素：
|
|
76
|
+
1. **做了什么动作**：说明该步骤执行的具体操作（点了什么按钮 / 执行了什么命令 / 打开了什么页面 / 填写了什么字段）
|
|
77
|
+
2. **配截图**：该步骤对应的界面截图，必须带箭头/红框/提示文字标注指向关键操作点或关键数据，标注放在页面空白区域，不遮挡关键内容
|
|
78
|
+
3. **详细说明结果**：这一步执行后出现了什么结果、验证了什么、为什么重要
|
|
79
|
+
- ⚠️ 步骤之间用编号衔接（步骤 1 → 步骤 2 → …），说明文字必须一图一句、逐张不同，禁止用一句套话覆盖所有步骤的截图
|
|
80
|
+
- 截图统一用 base64 data URI 内嵌，禁止引用外部图片文件
|