SuperAPI AI 工具集

using-grove

编程与开发

查看项目

更新于 10-16 05:02

技能介绍

用途:在需要与当前工作区隔离的功能开发开始时,或在 Grove 已启用的仓库中执行实现计划之前,使用该技能创建带预热构建状态的隔离工作区。

主要能力与用法:

  1. 先确认 Grove 已初始化:test -f "$(git rev-parse --show-toplevel)/.grove/config.json",若不存在需先用 grove-config 技能配置。
  2. 确认 CLI 已安装:command -v grove,未找到时参照 https://github.com/chrisbanes/grove 安装。
  3. 创建工作区:grove create --branch <branch-name> --json,从 JSON 输出解析 path 和 id。
  4. 进入工作区:cd <path-from-json>。
  5. 验证基线:根据标记文件自动识别测试命令,如 go.mod 用 go test ./...、package.json 用 npm test、Cargo.toml 用 cargo test、build.gradle 用 ./gradlew test、pyproject.toml 用 pytest、Makefile 用 make test。测试失败应报告并询问是否继续。
  6. 报告就绪状态。

常用命令:grove create --branch <name> --json 创建工作区;grove list 列出活动工作区;grove destroy <id> 删除工作区。

限制与注意事项:不要用普通 git worktree,因其构建缓存为冷启动,Grove 的 CoW 克隆保留预热构建状态使首次构建为增量式;必须加 --json 以可靠提取路径与 ID;未验证 Grove 初始化会导致 grove create 报错。常见问题包括 golden copy 未提交改动报错、基线测试失败需先运行 grove update、安装后命令找不到需检查 PATH(默认安装到 $GOPATH/bin)。该技能会替代 using-git-worktrees,建议禁用后者避免冲突,并与 finishing-grove-workspace 技能配合使用。