메뉴
当需要开始与当前工作区隔离的功能开发或执行实现计划之前使用——创建具有智能目录选择和安全验证的隔离 git 工作树
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
中文代码审查规范——在保持专业严谨的同时，用符合国内团队文化的方式给出有效反馈
中文 Git 提交规范 — 适配国内团队的 commit message 规范和 changelog 自动化
中文技术文档写作规范——排版、术语、结构一步到位，告别机翻味
适配国内 Git 平台和团队习惯的工作流规范——Gitee、Coding、极狐 GitLab 全覆盖
当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾
| name | using-git-worktrees |
| description | 当需要开始与当前工作区隔离的功能开发或执行实现计划之前使用——创建具有智能目录选择和安全验证的隔离 git 工作树 |
Git 工作树创建共享同一仓库的隔离工作区，允许同时在多个分支上工作而无需切换。
核心原则： 系统化的目录选择 + 安全验证 = 可靠的隔离。
开始时宣布： "我正在使用 using-git-worktrees 技能来建立一个隔离的工作区。"
按以下优先顺序执行：
# 按优先顺序检查
ls -d .worktrees 2>/dev/null # 首选（隐藏目录）
ls -d worktrees 2>/dev/null # 备选
如果找到： 使用该目录。如果两者都存在，.worktrees 优先。
grep -i "worktree.*director" CLAUDE.md 2>/dev/null
如果指定了偏好： 直接使用，无需询问。
如果没有现有目录且 CLAUDE.md 中无偏好设置：
未找到工作树目录。我应该在哪里创建工作树？
1. .worktrees/（项目本地，隐藏目录）
2. ~/.config/superpowers/worktrees/<project-name>/（全局位置）
你倾向哪个？
创建工作树前必须验证目录已被忽略：
# 检查目录是否被忽略（遵循本地、全局和系统 gitignore）
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
如果未被忽略：
根据 Jesse 的规则"立即修复坏掉的东西"：
为什么这很关键： 防止意外将工作树内容提交到仓库。
无需 .gitignore 验证——完全在项目之外。
project=$(basename "$(git rev-parse --show-toplevel)")
# 确定完整路径
case $LOCATION in
.worktrees|worktrees)
path="$LOCATION/$BRANCH_NAME"
;;
~/.config/superpowers/worktrees/*)
path="~/.config/superpowers/worktrees/$project/$BRANCH_NAME"
;;
esac
# 创建带有新分支的工作树
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"
自动检测并运行相应的设置命令：
# Node.js
if [ -f package.json ]; then npm install; fi
# Rust
if [ -f Cargo.toml ]; then cargo build; fi
# Python
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
if [ -f pyproject.toml ]; then poetry install; fi
# Go
if [ -f go.mod ]; then go mod download; fi
运行测试确保工作树初始状态干净：
# 示例 - 使用项目对应的命令
npm test
cargo test
pytest
go test ./...
如果测试失败： 报告失败情况，询问是否继续或排查。
如果测试通过： 报告就绪。
工作树已就绪：<full-path>
测试通过（<N> 个测试，0 个失败）
准备实现 <feature-name>
| 情况 | 操作 |
|---|---|
.worktrees/ 存在 | 使用它（验证已忽略） |
worktrees/ 存在 | 使用它（验证已忽略） |
| 两者都存在 | 使用 .worktrees/ |
| 都不存在 | 检查 CLAUDE.md → 询问用户 |
| 目录未被忽略 | 添加到 .gitignore + 提交 |
| 基线测试失败 | 报告失败 + 询问 |
| 无 package.json/Cargo.toml | 跳过依赖安装 |
git check-ignore你：我正在使用 using-git-worktrees 技能来建立一个隔离的工作区。
[检查 .worktrees/ - 存在]
[验证已忽略 - git check-ignore 确认 .worktrees/ 已被忽略]
[创建工作树：git worktree add .worktrees/auth -b feature/auth]
[运行 npm install]
[运行 npm test - 47 个通过]
工作树已就绪：/Users/jesse/myproject/.worktrees/auth
测试通过（47 个测试，0 个失败）
准备实现 auth 功能
绝不：
始终：
被以下技能调用：
配合使用：