SuperAPI AI 工具集

worktree

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

用途:在 mainline 仓库中从功能 worktree 开展工作,并通过 mq 将变更落地。它不替代首次环境搭建或仓库导览;新克隆或不清楚当前检出的用户应先使用 onboarding 技能。

主要能力与规则:main 保持干净,仓库根检出保持简单可信;每个任务使用独立 worktree;所有提交都在功能 worktree 中完成;落地通过 mq 而非手动合并到 main。禁止在受保护分支 worktree 上做功能开发、禁止把未完成工作提交到 main、禁止手动合并、禁止从功能 worktree 直接推送 origin/main。若受支持客户端用钩子阻止对受保护 main worktree 的原生 git 变更,应转到功能 worktree 继续,而不是绕过。

标准流程:先在干净的受保护分支 worktree(仓库根检出)确认状态与分支;必要时用 mq repo root --repo ~/Projects/recallnet/mainline --json 校验,配置漂移时用 --adopt-root 修复。然后创建功能 worktree:git worktree add ~/Projects/_wt/recallnet/mainline/<branch-name> -b <branch-name> main。所有编辑、测试、提交都在该 worktree 内进行。提交后通过 mq 提交,常用命令包括 mq submit --check-only --json、mq submit --wait --timeout 15m --json、mq submit --wait --for landed --timeout 30m --json、mq wait --submission <id> --for landed --json --timeout 30m、mq land --json --timeout 30m、mq events --follow --json --lifecycle。提交要求 worktree 干净、分支不是 main、属于同一仓库。落地使用 mq run-once 或 mq publish,并用 mq status、mq repo audit、mq events 验证。评审发现问题时回到同一功能 worktree 修复并重新提交。集成确认后再用 git worktree remove 与 git branch -d 清理。

限制:资料未提供安装方式、收费、平台支持与效果数据;PLAN.md 为前瞻产品计划,SPEC.md 为当前产品契约,若变更影响操作模型或产品边界需同步更新文档。