SuperAPI AI 工具集

git-worktrees

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:该技能用于在 Safe-Synthesizer 仓库中创建、清理或修剪隔离的 Git worktree,服务于功能开发、PR 审查和并行分支等场景,可在 Cursor、Claude Code、Codex 等客户端中使用。技能自包含,不应加载机器安装或系统级的 worktree 技能,除下述仓库规则外按标准 Git 行为执行。

主要能力与规则:保留无关改动,不得为创建工作树而 stash、移动或丢弃它们;不依赖客户端钩子,Cursor 通过 .cursor/worktrees.json 调用 scripts/setup-worktree.sh,其他客户端可在创建工作树后运行同一脚本;Codex 不读取该 JSON,需配置本地环境调用脚本或手动运行。机器本地配置保留在各检出中,worktree 钩子不会从其他检出复制 .env、.env.local、mise.local.toml 或 .local.envrc。

使用方式:若客户端未运行,请在新 worktree 中执行 .agents/skills/git-worktrees/scripts/setup-worktree.sh,它会创建基础本地 .venv。选择开发所需的完整依赖配置:unset UV_PROJECT_ENVIRONMENT UV_NO_SYNC PYTHONPATH VIRTUAL_ENV UV_PROJECT_DIR,然后 mise run setup,再 mise run bootstrap-nss cpu(或 cu129)。仅 uv sync --frozen 只安装基础环境,不支持全部类型检查、导入检查或 GPU 测试。仅当锁文件与依赖配置匹配时,才共享主检出的环境:SS_MAIN_CHECKOUT="$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")",export UV_PROJECT_ENVIRONMENT="$SS_MAIN_CHECKOUT/.venv",export UV_NO_SYNC=1,export PYTHONPATH="$PWD/src${PYTHONPATH:+:$PYTHONPATH}"。共享环境的同步由主检出负责,指向它的 worktree 不得运行 uv sync 或 bootstrap 任务。

限制:提交需要 DCO 签署与 GPG 签名,例如 git commit --signoff --gpg-sign -m "message"。资料未提供其他平台、收费或效果信息。