C✳CODEZ.WIN
🌐 简体中文

Skill 多语言阅读指南

using-git-worktrees用途、用法与原始来源

在开始需要与当前工作区隔离的功能开发工作时,或在执行实现计划之前使用此功能——确保通过原生工具或 Git 工作树回退机制存在一个隔离的工作区。

原文采集时间:

来源仓库
obra/superpowers
SKILL.md
skills/using-git-worktrees/SKILL.md
仓库 Star
309,479
仓库最近更新
2026/10/30
能力分类
开发
最近采集时间

许可:MIT

流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。

下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。

这个 Skill 能做什么

在开始需要与当前工作区隔离的功能开发工作时,或在执行实现计划之前使用此功能——确保通过原生工具或 Git 工作树回退机制存在一个隔离的工作区。

如何使用:上游操作流程

概述

确保工作在隔离的工作区内进行。优先使用平台自带的工作树工具。仅当没有自带工具可用时才回退到手动创建 Git 工作树。核心原则:首先检测已存在的隔离状态。然后使用自带工具。最后才回退到 Git。切勿与平台机制对抗。启动时声明:“我正在使用 using-git-worktrees 技能来设置一个隔离的工作区。”

原文片段 · L8 ↗

步0检测现有隔离

创建任何内容之前,请检查您是否已处于隔离的工作区中。子模块守卫:GIT_DIR != GIT_COMMON在 Git 子模块内部也同样适用。在得出“已在工作树中”的结论之前,请确认您不在子模块中:如果GIT_DIR != GIT_COMMON(而非子模块):您已位于链接的工作树中。跳至步骤2(项目设置)。请勿创建新的工作树。报告分支状态:

原文片段 · L16 ↗

步1创建独立工作区

你有两种方法。请按此顺序尝试。

原文片段 · L47 ↗
原文片段 · bash ↗
GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
BRANCH=$(git branch --show-current)

环境与依赖

步2项目设置

自动检测并运行相应的设置:

原文片段 · L102 ↗

限制与结果检查

安全验证(仅限项目本地目录)

必须先验证目录是否被忽略,然后再创建工作树:如果未被忽略:将其添加到 .gitignore 文件中,提交更改,然后继续。

原文片段 · L78 ↗

开始使用前

  1. 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
  2. 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
  3. 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
  4. 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。

Skill 文件与目录格式规范 ↗

继续阅读原始文档

翻译与介绍范围

本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。

介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。

固定版本来源
阅读原文 ↗
原文采集时间
来源提交版本
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b
原文 SHA-256
8cfb86f121269e8f7f12361e6795c4f6738828340e28964c9229d365666c9edd
返回完整 Skill 目录