菜单
在需要与当前工作区隔离的功能开发或执行实施计划前使用——创建隔离的 git worktree，支持智能目录选择和安全校验
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
在进行任何创造性工作前必须使用——创建功能、构建组件、添加新功能或修改行为。在实现之前先探索用户意图、需求和设计。
TypeScript 和 React 开发的编码标准与最佳实践。在编写或审查代码时激活。提供命名、类型、组件设计、Hook 提取、状态管理等规范。
在用户确认要提交代码变更时使用——安全检查 diff 中的敏感数据后执行 git commit
在面对 2 个以上互不依赖、无共享状态的独立任务时使用
当有已编写的实现计划需要在独立会话中执行时使用，包含评审检查点
在实现完成、测试通过后，引导决定如何集成工作——提供合并、PR 或清理的结构化选项
| name | using-git-worktrees |
| description | 在需要与当前工作区隔离的功能开发或执行实施计划前使用——创建隔离的 git worktree，支持智能目录选择和安全校验 |
Git worktrees 创建共享同一仓库的隔离工作区，允许同时在多个分支上工作，无需切换分支。
核心原则： 系统化的目录选择 + 安全校验 = 可靠的隔离。
启动时宣告： "我正在使用 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 中无偏好设置：
未找到 worktree 目录。请问应该在哪里创建 worktrees？
1. .worktrees/（项目本地，隐藏目录）
2. ~/.config/agent/worktrees/<项目名>/（全局位置）
你更倾向哪个？
创建 worktree 前必须验证目录已被 git 忽略：
# 检查目录是否被忽略（支持 local、global 和 system gitignore）
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
如果未被忽略：
遵循"立即修复问题"原则：
为什么这很关键： 防止 worktree 内容被意外提交到仓库。
无需 .gitignore 校验——完全在项目之外。
project=$(basename "$(git rev-parse --show-toplevel)")
# 确定完整路径
case $LOCATION in
.worktrees|worktrees)
path="$LOCATION/$BRANCH_NAME"
;;
~/.config/agent/worktrees/*)
path="~/.config/agent/worktrees/$project/$BRANCH_NAME"
;;
esac
# 创建 worktree 并新建分支
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
运行测试确保 worktree 起始状态正常：
# 示例——使用项目对应的测试命令
npm test
cargo test
pytest
go test ./...
如果测试失败： 报告失败，询问是继续还是排查问题。
如果测试通过： 报告就绪。
Worktree 已就绪：<完整路径>
测试通过（<N> 个测试，0 个失败）
准备实施 <功能名称>
| 场景 | 操作 |
|---|---|
.worktrees/ 已存在 | 使用它（校验已忽略） |
worktrees/ 已存在 | 使用它（校验已忽略） |
| 两者都存在 | 使用 .worktrees/ |
| 两者都不存在 | 检查 CLAUDE.md → 询问用户 |
| 目录未被忽略 | 添加到 .gitignore + 提交 |
| 基线测试失败 | 报告失败 + 询问 |
| 无 package.json/Cargo.toml | 跳过依赖安装 |
git check-ignore你：我正在使用 using-git-worktrees 技能来设置隔离工作区。
[检查 .worktrees/ - 已存在]
[校验忽略 - git check-ignore 确认 .worktrees/ 已被忽略]
[创建 worktree：git worktree add .worktrees/auth -b feature/auth]
[运行 npm install]
[运行 npm test - 47 个通过]
Worktree 已就绪：/Users/jesse/myproject/.worktrees/auth
测试通过（47 个测试，0 个失败）
准备实施 auth 功能
绝不：
始终：
被以下技能调用：
搭配使用：