@routerhub/agent-rules 1.5.92 → 1.5.94

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 CHANGED
@@ -106,6 +106,7 @@
106
106
  ## Figma 还原
107
107
 
108
108
  - Figma 设计还原使用 `/figma-to-code` skill,按 MCP 三步验证法执行。
109
+ - ⚠️ **禁止用截图还原页面,必须走 Figma MCP。** 截图只能得到像素观感,拿不到真实的尺寸、间距、颜色 token、字体、层级结构等设计数据,还原结果必然失真。所有 Figma 还原必须通过 MCP 读取节点的结构化设计信息。
109
110
 
110
111
  ## TDD 开发
111
112
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@routerhub/agent-rules",
3
- "version": "1.5.92",
3
+ "version": "1.5.94",
4
4
  "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
5
5
  "main": "AGENTS.base.md",
6
6
  "bin": {
package/rules/global.md CHANGED
@@ -106,6 +106,7 @@ name: "通用规则"
106
106
  ## Figma 还原
107
107
 
108
108
  - Figma 设计还原使用 `/figma-to-code` skill,按 MCP 三步验证法执行。
109
+ - ⚠️ **禁止用截图还原页面,必须走 Figma MCP。** 截图只能得到像素观感,拿不到真实的尺寸、间距、颜色 token、字体、层级结构等设计数据,还原结果必然失真。所有 Figma 还原必须通过 MCP 读取节点的结构化设计信息。
109
110
 
110
111
  ## TDD 开发
111
112
 
@@ -6,7 +6,7 @@ description: >-
6
6
  「帮我部署」「帮我发布」「帮我上线」「部署一下」「发布一下」「上线一下」「部署吧」「发布吧」「上线吧」「部署了」「发布了」「上线了」「搞部署」「做部署」「弄部署」。
7
7
  「打测试」「打test」「打一下测试」「打个测试包」「打包测试」「打包到测试」「发版测试」「发版到测试」。
8
8
  「部署」「发布」「上线」单独说且上下文在讨论测试环境时也应触发。
9
- 自动完成:记录当前分支→合并到test→推送→部署→发版→切回原分支。
9
+ 自动完成:记录当前分支→提交并推送当前分支→合并到test→推送→部署→发版→切回原分支。
10
10
  ---
11
11
 
12
12
  # 部署测试环境
@@ -17,7 +17,7 @@ description: >-
17
17
 
18
18
  ## 🚨 铁律(违反即错误)
19
19
 
20
- - ⚠️ 部署测试环境**唯一正确流程**:当前功能分支 → 合并到 test → 推送 test → 触发部署 → 切回原分支。
20
+ - ⚠️ 部署测试环境**唯一正确流程**:当前功能分支 → 提交并推送当前分支 → 合并到 test → 推送 test → 触发部署 → 切回原分支。
21
21
  - ⚠️ **绝对禁止**跳过合并步骤、直接在功能分支上部署、或往 test 分支直接提交代码。
22
22
  - ⚠️ 每一步必须执行完毕并确认成功后才能进入下一步,不可并行或跳过。
23
23
 
@@ -30,7 +30,17 @@ ORIGINAL_BRANCH=$(git branch --show-current)
30
30
  echo "当前分支: $ORIGINAL_BRANCH"
31
31
  ```
32
32
 
33
- ### 2. test 分支检查
33
+ ### 2. 提交当前分支并推送远程
34
+
35
+ ⚠️ 合并前必须确保当前分支所有改动已提交并推送,避免遗漏代码。
36
+
37
+ ```bash
38
+ git add -A
39
+ git commit -m "..." # 使用有意义的提交信息
40
+ git push origin "$ORIGINAL_BRANCH"
41
+ ```
42
+
43
+ ### 3. test 分支检查
34
44
 
35
45
  如果 `test` 分支不存在,从主分支创建:
36
46
 
@@ -43,29 +53,31 @@ if ! git show-ref --verify --quiet refs/heads/test; then
43
53
  fi
44
54
  ```
45
55
 
46
- ### 3. 合并当前分支到 test
56
+ ### 4. 合并当前分支到 test
57
+
58
+ ⚠️ 合并发生冲突时,以当前功能分支的内容为准(`-X theirs`)。因为当前分支的代码是刚改的最新版本,test 分支上的旧版本直接覆盖即可。
47
59
 
48
60
  ```bash
49
61
  git checkout test
50
62
  git pull origin test
51
- git merge "$ORIGINAL_BRANCH"
63
+ git merge "$ORIGINAL_BRANCH" -X theirs
52
64
  ```
53
65
 
54
- ### 4. 推送 test 分支
66
+ ### 5. 推送 test 分支
55
67
 
56
68
  ```bash
57
69
  git push origin test
58
70
  ```
59
71
 
60
- ### 5. 部署 test 分支
72
+ ### 6. 部署 test 分支
61
73
 
62
74
  按项目自己的部署方式执行(Cloud Run / 容器 / npm publish 等)。
63
75
 
64
- ### 6. 发新版本
76
+ ### 7. 发新版本
65
77
 
66
78
  按项目发版规则执行(如 `./release.sh`)。
67
79
 
68
- ### 7. 切回原功能分支
80
+ ### 8. 切回原功能分支
69
81
 
70
82
  ```bash
71
83
  git checkout "$ORIGINAL_BRANCH"
@@ -76,5 +88,6 @@ git checkout "$ORIGINAL_BRANCH"
76
88
  - ⚠️ 推送 test 后必须立即执行 `git push origin test`
77
89
  - ⚠️ 部署完成后必须立即切回原功能分支
78
90
  - ⚠️ 部署必须自包含:migration、配置变更、依赖检查全部脚本化自动执行,禁止部署后人工补操作
91
+ - ⚠️ 合并到 test 发生冲突时,必须用 `-X theirs`(以当前功能分支为准),因为当前分支是最新代码,test 旧版本直接覆盖即可。
79
92
  - 禁止直接往 test 分支提交代码
80
93
  - 敏感信息(密钥、Token)必须从 Nacos 配置中心拉取,不得写死