docs(agents): allow direct main development
This commit is contained in:
parent
0b6b39f262
commit
92ca6e460e
30
AGENTS.md
30
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) 安全与仓库卫生
|
||||
|
||||
Loading…
Reference in New Issue
Block a user