docs(agents): require isolated git worktree for all changes, merge to main, then clean up
This commit is contained in:
parent
51acb0effa
commit
2d21ed9bcd
22
AGENTS.md
22
AGENTS.md
|
|
@ -87,3 +87,25 @@
|
||||||
- **渲染图标(Rendered Sprite Billboard)**:投射物的视觉图元是基于原版 DCC 导出的 2.5D 公告板(Billboard),其在渲染时由 `drawMissileProjectile` 通过 `shot.x + frame.anchorX`, `shot.y + frame.anchorY` 锚点对齐绘制,并依据切线速度向量 `(vx, vy)` 的朝向动态选取 16/32 方向的 DCC 预烘焙视角图。
|
- **渲染图标(Rendered Sprite Billboard)**:投射物的视觉图元是基于原版 DCC 导出的 2.5D 公告板(Billboard),其在渲染时由 `drawMissileProjectile` 通过 `shot.x + frame.anchorX`, `shot.y + frame.anchorY` 锚点对齐绘制,并依据切线速度向量 `(vx, vy)` 的朝向动态选取 16/32 方向的 DCC 预烘焙视角图。
|
||||||
- **严禁混淆两者的职责**:绝对禁止通过拉伸/变形渲染图标去强行模拟椭圆,也绝对禁止把渲染图标的像素尺寸误当作物理坐标。渲染图标保持原版 DCC 原始比例,而物理轨迹坐标严格遵循 2:1 地面椭圆数学方程。
|
- **严禁混淆两者的职责**:绝对禁止通过拉伸/变形渲染图标去强行模拟椭圆,也绝对禁止把渲染图标的像素尺寸误当作物理坐标。渲染图标保持原版 DCC 原始比例,而物理轨迹坐标严格遵循 2:1 地面椭圆数学方程。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Git Worktree 隔离开发铁律 (Mandatory Worktree Isolation)
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> 适用于所有人类开发者与所有 AI Agent(包括 teamwork 多智能体编排器及其派生的全部子 Agent)。
|
||||||
|
|
||||||
|
1. **所有新改动必须在独立 worktree 中进行**:
|
||||||
|
- 任何代码、脚本、资产、测试或文档改动,开工前必须先从最新 `main` 新开独立分支与 worktree,例如:
|
||||||
|
`git worktree add -b <type>/<topic> .worktrees/<topic> main`
|
||||||
|
- **严禁直接在主工作区(仓库根目录的 `main` 检出)上编辑文件或提交。**
|
||||||
|
2. **不得触碰他人未提交的改动**:
|
||||||
|
- 主工作区或其他 worktree 中存在的未提交改动(modified / untracked)属于其他进行中的工作,严禁 `checkout`、`restore`、`stash`、`reset`、`clean`、覆盖或顺带提交。
|
||||||
|
- 合并时只允许带入本 worktree 分支自身的提交。
|
||||||
|
3. **完成后合并回 `main`**:
|
||||||
|
- 在 worktree 内完成开发并通过门禁(`npm run typecheck` 0 errors、相关 `vitest` 全部通过)后,再合并回 `main`(优先 fast-forward;若 `main` 已前进,先在 worktree 内 rebase 到最新 `main` 并重新验证)。
|
||||||
|
- 合并后推送到 `origin/main`。
|
||||||
|
4. **合并后必须清理 worktree**:
|
||||||
|
- 合并并推送成功后,立即执行 `git worktree remove .worktrees/<topic>` 与 `git branch -d <type>/<topic>`,并执行 `git worktree prune`,确保不遗留悬空 worktree 或分支。
|
||||||
|
5. **一个主题一个 worktree**:
|
||||||
|
- 不同功能、不同 issue 使用不同 worktree,严禁在同一 worktree 中混杂无关改动。
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue