Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

docs: require syncing latest remote code before push

usoon.xu8a7917951407
diff --git a/AGENTS.md b/AGENTS.md
index 0f9079a..0145e31 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -36,6 +36,7 @@
- 优先选择小而清晰、对仓库和 Agent 都友好的抽象。
- 回复默认跟随用户提问所使用的语言;如果用户切换语言,回复语言也随之切换。
- 如果用户这一轮输入是英文,则直接用英文回复。
+- 推送前先同步远端最新代码,再执行 `git push`。
- prompt、规则、架构约束尽量都版本化落在仓库里。
- 复杂任务不要只靠聊天上下文,应该落 execution plan。
- 完成的代码变更要记到 `docs/histories/`。
diff --git a/docs/REPO_COLLAB_GUIDE.md b/docs/REPO_COLLAB_GUIDE.md
index 414841b..7cb1f11 100644
--- a/docs/REPO_COLLAB_GUIDE.md
+++ b/docs/REPO_COLLAB_GUIDE.md
@@ -21,6 +21,7 @@
## Git 与评审
- commit 尽量保持范围清晰、描述准确。
+- `git push` 前先同步远端最新代码,避免把过期分支状态直接推上去。
- 提交或发 PR 前,确认文档、示例、脚本和 history 是否已经反映最终状态。
- 复杂或高风险改动,先落一份 execution plan 到 `docs/exec-plans/`。
- 评审里尽量引用仓库内文件,不要依赖只有少数人知道的上下文。
diff --git a/docs/histories/2026-04/20260422-1601-require-pull-latest-before-push.md b/docs/histories/2026-04/20260422-1601-require-pull-latest-before-push.md
new file mode 100644
index 0000000..4e18c1f
--- /dev/null
+++ b/docs/histories/2026-04/20260422-1601-require-pull-latest-before-push.md
@@ -0,0 +1,20 @@
+## [2026-04-22 16:01] | Task: require syncing latest remote code before push
+
+### 背景
+
+- 用户要求把“push 前先拉最新代码”补进仓库规则,并明确加到 `AGENTS.md`。
+
+### 变更
+
+- **[Agent Routing]**: 在 `AGENTS.md` 的工作规则中补充显式约束:推送前先同步远端最新代码,再执行 `git push`。
+- **[Canonical Repo Rule]**: 在 `docs/REPO_COLLAB_GUIDE.md` 的 Git 约定中同步同一条规则,避免该要求只停留在入口导航文档里。
+
+### 验证
+
+- 通过:`make check-docs`
+
+### 影响文件
+
+- `AGENTS.md`
+- `docs/REPO_COLLAB_GUIDE.md`
+- `docs/histories/2026-04/20260422-1601-require-pull-latest-before-push.md`