From 92ca6e460e67f7ae16225c1ec625cd74ba31222b Mon Sep 17 00:00:00 2001
From: JOJO <1498581755@qq.com>
Date: Thu, 28 May 2026 14:30:44 +0800
Subject: [PATCH] docs(agents): allow direct main development

---
 AGENTS.md | 30 ++++++++----------------------
 1 file changed, 8 insertions(+), 22 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 3cc0566..c204fbc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -96,10 +96,10 @@
 
 ### 6.1 核心原则
 
-- **永远不直接在 `main` 上开发**。所有改动走功能分支，合入时 Squash Merge。
-- 每个功能分支合入 main 后，main 上对应一个 commit（一个功能 = 一个 commit），历史干净可回滚。
+- 默认直接在 `main` 上开发，不强制新建功能分支。
+- 每个功能建议在 `main` 上保持一个清晰 commit，历史干净可回滚。
 - 使用 **Conventional Commits**：`feat:` `fix:` `refactor:` `chore:` `docs:` `test:` `perf:`。
-- 个人项目，不设 PR 和 Review 流程。功能分支 = 隔离容器，写完即合。
+- 个人项目，不设 PR 和 Review 流程；如用户临时要求隔离开发，再按需新建分支。
 
 ### 6.2 工作流（唯一步骤）
 
@@ -108,13 +108,12 @@ AI 执行以下流程时，每一步都要向用户说明在做什么：
 ```
 0. 检查工作区状态
    git status
-   如有未提交的改动（切换分支可能丢失）：
+   如有未提交的改动：
    - 若无关：提醒用户先 commit 或 discard
    - 若有关：git stash push -m "WIP: <简短描述>" 暂存
 
-1. 从 main 切出功能分支
+1. 确认在 main 并同步最新代码
    git checkout main && git pull origin main
-   git checkout -b feature/<简短描述> main
 
 2. 开发并提交
    git add <修改的文件>
@@ -122,36 +121,23 @@ AI 执行以下流程时，每一步都要向用户说明在做什么：
    （多轮迭代可用 git commit --amend 保持一个 commit）
 
 3. 推送到远程（备份 + 方便切设备）
-   git push origin feature/<分支名>
-
-4. Squash Merge 到 main
-   git checkout main && git pull origin main
-   git merge --squash feature/<分支名>
-   git commit -m "feat(scope): 简短描述"
    git push origin main
-
-5. 清理
-   git branch -D feature/<分支名>
-   git push origin --delete feature/<分支名>
 ```
 
 **重要约束**：
 - AI 必须在本地验证修改能正常运行，再建议用户提交。
 - 修改完成后主动告知：修改了哪些文件、核心变更点、验证结果。
 - 禁止 AI 在未经用户确认的情况下执行 `git push`。
-- 如需 Review，在同一对话内直接 `git diff main...feature/<分支>` 即可，不必跨对话。
+- 如需 Review，在同一对话内直接 `git diff` 或 `git diff HEAD~1..HEAD` 即可，不必跨对话。
 
 ### 6.3 常用命令速查
 
 | 操作 | 命令 |
 |------|------|
-| 切功能分支 | `git checkout -b feature/<名称> main` |
 | 暂存未完成工作 | `git stash push -m "WIP: xxx"` |
 | 修改最近 commit | `git commit --amend` |
-| Squash Merge | `git merge --squash feature/<名称>` |
-| 强制删除本地分支 | `git branch -D feature/<名称>` |
-| 删除远程分支 | `git push origin --delete feature/<名称>` |
-| 同对话内 Review diff | `git diff main...feature/<名称>` |
+| 同步 main | `git checkout main && git pull origin main` |
+| 同对话内 Review diff | `git diff` 或 `git diff HEAD~1..HEAD` |
 | 查看提交历史 | `git log --oneline -10` |
 
 ## 7) 安全与仓库卫生