Skip to content

Commit f2a4a73

Browse files
committed
Document worktree cleanup workflow
1 parent cd9ddc3 commit f2a4a73

2 files changed

Lines changed: 11 additions & 0 deletions

File tree

.agents/skills/tritonkit-ops-governance/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,7 @@ metadata:
5959
- qmd 写回同步优先使用 `docs-linhay/scripts/qmd-sync.sh`。当前 qmd CLI 不支持 `update/embed` 按 collection 过滤,脚本仍会执行全量维护并显式提示这一限制。
6060
- 用户要求“整理会话”时,先用 `git status --short --branch``git diff --stat` 隔离已提交代码、未提交文档、外部仓验证和临时产物;只 stage 本次整理相关文件,不默认 `git add -A`
6161
- 用户要求 subagent 并行处理多个 GitHub issue 且强调不要串工作时,按 issue 建独立 `space` / `feat/<space-key>` / `../TritonKit-worktrees/<space-key>/`;主控 agent 逐 worktree 检查 clean status、commit、测试、docs/memory/qmd,不把多个 issue 或主仓并行改动混成一个提交。
62+
- 用户要求“其他 worktree 都结束了就合并到主分支后删除”时,收尾顺序固定为:`git worktree list --porcelain` 枚举,逐 worktree 跑 `git status --short --branch`,用 `git log main..<branch>``git merge-base --is-ancestor` 判断是否还有未合入提交,对需要合入的分支先用 `git merge-tree --write-tree main <branch>` 做无副作用冲突预检;合入主仓后必须在主仓跑门禁,通过后再 `git worktree remove <path>`,最后复查 registered worktree 只剩主仓。空包装目录可在确认不是 registered worktree 且为空后用 `rmdir` 清理;本地/远端分支不随 worktree 默认删除。
6263
- 调整 CI、Release 或发布产物契约时,同步更新 `docs-linhay/dev/` 与 memory。
6364
- 调整 Homebrew、tap、checksum 或 release asset 命名时,同步更新 README、`.github/homebrew/``docs-linhay/dev/` 与 memory。
6465
- 调整 replay plan schema、record/replay 行为或 `.tritonplan` 对外契约时,同步更新 README、`docs-linhay/dev/ai-cli-readable-control.md`、真实项目回归 skill 与 memory。

docs-linhay/memory/2026-06-07.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,3 +60,13 @@
6060
- 回归:
6161
- `swift test --filter TKPlatformFallbackTests` 通过。
6262
- 主仓 `docs-linhay/scripts/verify.sh --local` 通过。
63+
64+
## 会话整理:多 worktree 收尾
65+
66+
- 本轮用户要求检查其他 worktree,结束后合并到主分支并删除;实际处理了 issue 26、issue 27 与 Android Emulator support 三个 worktree。
67+
- 稳定可复用模式已沉淀到 `.agents/skills/tritonkit-ops-governance/SKILL.md`
68+
- 先枚举 registered worktree 和 clean status。
69+
-`git log main..<branch>``git merge-base --is-ancestor``git merge-tree --write-tree main <branch>` 区分已包含、可合入和有冲突的分支。
70+
- 合入主仓并跑主仓门禁后,再 `git worktree remove` 删除已结束 worktree。
71+
- 只删除 registered worktree 与确认为空的包装目录;不默认删除本地或远端分支。
72+
- 不升级 `AGENTS.md`:现有 AGENTS 已有 worktree 路径、合并后删除与 space 保留规则;本次沉淀属于执行顺序细化,放在内部治理 skill 更合适。

0 commit comments

Comments
 (0)