القائمة
当开始撰写需要与当前工作区隔离的新章节，或在执行撰写计划之前使用——通过智能目录选择和安全验证创建隔离的草稿分支
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当面临 2+ 个独立任务，可以在没有共享状态或顺序依赖的情况下工作时使用
当在当前会话中执行具有独立任务的撰写计划时使用
当你有一个书面的撰写实施计划，需要在一个单独的会话中执行，并带有审查检查点时使用
当收到同行评审反馈时使用，在实施建议之前，特别是当反馈看起来不清楚或在学术上值得商榷时——需要学术严谨和验证，而不是表演性的同意或盲目实施
当撰写完成，所有逻辑检查通过，你需要决定如何整合工作时使用——通过展示清晰的合并、提交审阅或清理选项来指导完成开发工作
在进行任何创造性工作之前必须使用此技能——无论是撰写新章节、构建理论框架、增加论据还是修改论证逻辑。在撰写正文之前，先探索研究目标、要求和论证设计。
| name | sa-isolation |
| description | 当开始撰写需要与当前工作区隔离的新章节，或在执行撰写计划之前使用——通过智能目录选择和安全验证创建隔离的草稿分支 |
草稿分支创建共享同一存储库的隔离工作区，允许同时处理多个章节的草稿而无需切换上下文。
核心原则： 系统化目录选择 + 安全验证 = 可靠的写作隔离。
开始时声明： “我正在使用 isolation 技能来设置隔离的写作工作区。”
遵循此优先级顺序：
# 按优先级检查
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
如果未被忽略：
根据“立即修复损坏的东西”规则：
为什么关键： 防止意外将临时草稿目录提交到存储库。
不需要 .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"
自动检测并运行适当的设置（针对学术写作环境，如 LaTeX 或 Markdown）：
# LaTeX 项目
if [ -f main.tex ]; then echo "LaTeX project detected"; fi
# Markdown/Pandoc 项目
if [ -f Makefile ]; then make setup; fi
运行验证脚本以确草稿从干净状态开始：
# 示例
make verify
# 或
./scripts/validate_structure.sh
如果验证失败： 报告失败，询问是否继续或调查。
如果验证通过： 报告准备就绪。
草稿工作区就绪于 <full-path>
基线检查通过
准备撰写 <chapter-name>
| 情况 | 行动 |
|---|---|
.worktrees/ 存在 | 使用它（验证已忽略） |
worktrees/ 存在 | 使用它（验证已忽略） |
| 两者都存在 | 使用 .worktrees/ |
| 都不存在 | 检查 CLAUDE.md → 询问用户 |
| 目录未忽略 | 添加到 .gitignore + 提交 |
| 基线验证失败 | 报告失败 + 询问 |
git check-ignore你: 我正在使用 isolation 技能来设置隔离的写作工作区。
[检查 .worktrees/ - 存在]
[验证已忽略 - git check-ignore 确认 .worktrees/ 已忽略]
[创建工作树: git worktree add .worktrees/chapter2 -b draft/chapter2]
[运行基线检查 - 通过]
草稿工作区就绪于 /Users/researcher/thesis/.worktrees/chapter2
基线检查通过
准备撰写第二章
绝不：
始终：
调用者：
配对：