SuperAPI AI 工具集

recursive-worktree

编程与开发

查看项目

更新于 10-16 01:27

技能介绍

用途:recursive-worktree 是 recursive-mode 运行开始时使用的技能,负责在 Phase 1+ 工作开始前建立隔离的 git worktree。整体工作流仍以 /.recursive/RECURSIVE.md 为准,本技能只覆盖 00-worktree.md 的工作区隔离纪律。

硬性规则:在功能分支 worktree 存在、worktree 目录被 git 忽略(若位于仓库内)、项目初始化完成、以及记录干净或明确确认的基线测试状态之前,不得推进递归模式的阶段工作。

默认位置优先级:已有 .worktrees/ → 已有 worktrees/ → 仓库说明中记录的偏好 → 询问用户 → 默认 .worktrees/。全局回退位置为 ~/.config/recursive-mode/worktrees/<project-name>/。

主分支保护:若当前分支是 main 或 master,默认创建功能分支 worktree:git worktree add .worktrees/<run-id> -b recursive/<run-id>,然后 cd .worktrees/<run-id>。若用户坚持在主分支工作,需在 00-worktree.md 中记录该例外。

Phase 0 清单:00-worktree.md 需覆盖选定的 worktree 位置、git-ignore 验证、分支名与 worktree 路径、执行的 setup 命令、基线测试命令与结果、归一化 diff 依据字段(Baseline type、Baseline reference、Comparison reference、Normalized baseline、Normalized comparison、Normalized diff command)、后续阶段从 worktree 运行的明确说明,以及脚手架要求的 ## TODO 标题。

常用命令:检查分支用 git branch --show-current;检查忽略状态用 git check-ignore -q .worktrees || git check-ignore -q worktrees;创建 worktree 用 git worktree add .worktrees/<run-id> -b recursive/<run-id>。

初始化指引:按仓库类型执行对应命令,Node.js 用 npm install,Rust 用 cargo build,Python 用 pip install -r requirements.txt 或项目专用安装,Go 用 go mod download,Maven 用 mvn compile -q,Gradle 用 ./gradlew compileJava,.NET 用 dotnet restore;随后运行适合项目的基线测试命令并把结果记录到 00-worktree.md。

路由状态:在隔离 worktree 中运行被委派或路由的工作前,须在同一 worktree 内验证 .recursive/config/recursive-router.json 与 .recursive/config/recursive-router-discovered.json 是否存在。若控制器/源仓库有已配置的路由策略或发现清单而 worktree 缺失,应先同步两个文件再解析或调用路由角色;保留用户在 worktree 策略中的修改,更改绑定时优先使用 recursive-router-configure 而非手工编辑。recursive-router-discovered.json 是本地发现状态,可能未跟踪,在新 worktree 中缺失属预期,但仍不应基于过时假设解析外部角色,可用 python ./.recursive/scripts/recursive-router-probe.py --repo-root . --json 从 worktree 刷新,或从控制器/源仓库复制当前清单。接受路由工作前,需在 00-worktree.md 或委派动作记录中记录路由策略路径、发现路径、验证/探测命令与最终路由决策。

输出契约:产物写入 /.recursive/run/<run-id>/00-worktree.md,使用命名格式为 recursive/<run-id> 的功能分支。

路由意识:若本技能使用委派审查或其他路由外部模型来验证 worktree 设置、基线验证或分支安全,须在选择该 CLI/模型前立即重新读取上述两个路由配置文件,遵循路由策略或明确回退,不得硬编码审查模型。

集成:在 AS-IS 分析与规划之前调用本技能;Phase 0 锁定有效后,从 worktree 上下文继续运行。后续阶段(包括 STATE.md、DECISIONS.md 与记忆更新)保持在同一功能分支,直到合并。