@routerhub/agent-rules 1.5.145 → 1.5.146
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 +11 -0
- package/package.json +1 -1
- package/rules/global.md +11 -0
package/AGENTS.base.md
CHANGED
|
@@ -116,6 +116,17 @@
|
|
|
116
116
|
- ⚠️ **已推送到远程的提交需要撤销时，必须用 `git revert`，禁止用 `git push --force` 覆盖远程历史。** `git revert` 会创建一条新的撤销提交，保留完整的操作记录，不影响其他协作者的本地分支；`git push --force` 会破坏远程历史，导致其他人的本地分支与远程脱节，极易引发合并冲突或丢失他人提交。
|
|
117
117
|
- ⚠️ **提交并推送代码后，若发现与主分支存在冲突，必须主动解决**，不能推送完就算完事、把冲突留给别人处理。
|
|
118
118
|
|
|
119
|
+
## ⚠️ PR 冲突修复统一用临时 worktree
|
|
120
|
+
|
|
121
|
+
- ⚠️ **修复 PR 与主分支的冲突时，一律使用临时 git worktree，禁止直接在当前工作副本上切换分支（`git checkout`）解题。** 原因：A-/B-/C-/M- 多副本仓库中，同一个克隆往往同时被其他开发任务占用；直接切分支会破坏别人正在进行的代码、或把自己卡在非主分支上。
|
|
122
|
+
- ⚠️ **标准操作流程**：
|
|
123
|
+
1. 在仓库根目录执行 `git worktree add ../<pr>-fix <PR分支名> --detach`（或 `-b` 新建一个与 PR 分支同名的分支），临时分离出来用独立目录操作，当前工作副本状态完全不动。
|
|
124
|
+
2. 在 worktree 目录里 `git merge origin/main`（或 `git rebase origin/main`）→ 解决冲突文件 → 本地测试通过。
|
|
125
|
+
3. `git push` 推送回 PR 分支（须确认 push 目标为 origin 的对应 PR 分支，禁止 `--force`）。
|
|
126
|
+
4. 操作完成后用 `git worktree remove ../<pr>-fix` 清理临时 worktree，再回到原副本继续。
|
|
127
|
+
- ⚠️ **worktree 与主副本共享同一套本地 `.git`**，但工作目录、索引、当前分支状态完全独立，不会干扰正在 main 或其他分支上改动代码的协作者。
|
|
128
|
+
- ⚠️ **worktree 目录默认在仓库根目录同级（`../`）**，避免被误当成子文件夹进 git；进入前先确认该路径不存在同名文件夹。
|
|
129
|
+
|
|
119
130
|
## PR 核心要求
|
|
120
131
|
|
|
121
132
|
- ⚠️ PR Title / Description / Test Plan 全部中文。
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -116,6 +116,17 @@ name: "通用规则"
|
|
|
116
116
|
- ⚠️ **已推送到远程的提交需要撤销时，必须用 `git revert`，禁止用 `git push --force` 覆盖远程历史。** `git revert` 会创建一条新的撤销提交，保留完整的操作记录，不影响其他协作者的本地分支；`git push --force` 会破坏远程历史，导致其他人的本地分支与远程脱节，极易引发合并冲突或丢失他人提交。
|
|
117
117
|
- ⚠️ **提交并推送代码后，若发现与主分支存在冲突，必须主动解决**，不能推送完就算完事、把冲突留给别人处理。
|
|
118
118
|
|
|
119
|
+
## ⚠️ PR 冲突修复统一用临时 worktree
|
|
120
|
+
|
|
121
|
+
- ⚠️ **修复 PR 与主分支的冲突时，一律使用临时 git worktree，禁止直接在当前工作副本上切换分支（`git checkout`）解题。** 原因：A-/B-/C-/M- 多副本仓库中，同一个克隆往往同时被其他开发任务占用；直接切分支会破坏别人正在进行的代码、或把自己卡在非主分支上。
|
|
122
|
+
- ⚠️ **标准操作流程**：
|
|
123
|
+
1. 在仓库根目录执行 `git worktree add ../<pr>-fix <PR分支名> --detach`（或 `-b` 新建一个与 PR 分支同名的分支），临时分离出来用独立目录操作，当前工作副本状态完全不动。
|
|
124
|
+
2. 在 worktree 目录里 `git merge origin/main`（或 `git rebase origin/main`）→ 解决冲突文件 → 本地测试通过。
|
|
125
|
+
3. `git push` 推送回 PR 分支（须确认 push 目标为 origin 的对应 PR 分支，禁止 `--force`）。
|
|
126
|
+
4. 操作完成后用 `git worktree remove ../<pr>-fix` 清理临时 worktree，再回到原副本继续。
|
|
127
|
+
- ⚠️ **worktree 与主副本共享同一套本地 `.git`**，但工作目录、索引、当前分支状态完全独立，不会干扰正在 main 或其他分支上改动代码的协作者。
|
|
128
|
+
- ⚠️ **worktree 目录默认在仓库根目录同级（`../`）**，避免被误当成子文件夹进 git；进入前先确认该路径不存在同名文件夹。
|
|
129
|
+
|
|
119
130
|
## PR 核心要求
|
|
120
131
|
|
|
121
132
|
- ⚠️ PR Title / Description / Test Plan 全部中文。
|