本技能用于创建研究用的 Git 分支或工作树，把代码管理与论文版本管理分开处理，避免项目级管理与组件仓库管理相互混淆。适用对象包括：代码、实验、基线、功能、调试、反驳实现分支；论文投稿分支（如 NeurIPS、ICML、ICLR、CVPR、ACL、EMNLP）；arXiv 发布版本；camera-ready 版本。
主要能力与工作方式：
-
创建前检测：通过 git rev-parse --git-common-dir 与 --show-toplevel 确认当前操作的仓库；在项目控制根布局下判断目标是根仓库、code/ 还是 paper/。若存在 memory/BRIEFING.md，则读取其中当前阶段与活跃工作树，同时读取 memory/project-conventions.md 了解工作树命名策略与路径约定。创建前用 git worktree list 检查现有工作树，避免名称冲突或产生孤立工作树。
-
目标分类：向用户确认工作空间类型（分支或工作树）、组件（代码或论文）、分支类型与名称、目标仓库路径；论文工作空间还需确认源可见性层级、受众、同步目标与清理关卡，以及是否写入工作树记忆。
-
命名与目录：分支采用 <branch-type>/<branch-name>，示例包括 exp/new-loss、baseline/fair-tuning、debug/nan-loss、rebuttal/add-ablation、feature/data-loader、venue/neurips、venue/icml、arxiv/v1、camera-ready/neurips、private/draft、overleaf/main-clean。工作树目录名把斜杠替换为连字符。完整研究项目中，代码工作树放在 <ProjectName>/code-worktrees/，论文工作树放在 <ProjectName>/paper-worktrees/；除非用户明确要求，避免嵌套在 code/ 或 paper/ 内部。
-
Git 状态校验与创建：检查 status、当前分支与工作树列表；若有未提交改动，询问提交、暂存、仅建分支或取消。创建分支使用 git checkout -b，创建工作树使用 git worktree add；分支已存在时询问是否基于已有分支创建。
-
本地工具与共享资产：复制存在的 .vscode/、.cursor/、.claude/（复制而非软链接，因每个工作树可能需要独立 IDE 状态）；若存在 .worktree-links，则按其中相对路径把共享大资产以绝对目标软链接进工作树，典型条目有 data/、models/、.env、configs/local_settings.yaml。
-
组件路径准备：代码工作树确保 docs/results/、docs/reports/、docs/runs/、.agent/ 存在，分别存放稳定结果摘要、实验报告与运行指针（作业 ID、配置路径、提交哈希、远程路径、简要指标），.agent/worktree-status.md 记录用途、关联主张、最新可靠状态与退出条件；不把原始日志、检查点、wandb 运行、tensorboard 缓存或大输出放入 docs/。论文工作树确保 .agent/ 存在，并记录目标会议或发布、投稿模式、模板差异、源可见性层级、受众与同步目标、允许与禁止路径、清理关卡与清理要求、tex-fmt 源格式检查、Overleaf/GitHub 编译状态与分支映射。
-
环境同步：代码工作树若存在 pyproject.toml，执行 uv sync；若失败则报告错误但不删除工作树。论文工作树默认不安装 TeX，使用项目编译流程（本地静态检查、可用的 tex-fmt、GitHub 关联的 Overleaf）。
-
工作树记忆与项目记忆：更新 .agent/worktree-status.md，并可在 memory/component-index.yaml、组件 .agent/worktree-index.md、memory/source-visibility-board.md、memory/action-board.md、memory/current-status.md、memory/project-conventions.md 中添加简短指针；仅记录持久性指针，不记录日志。
-
最终汇总：报告仓库、分支、工作树路径、证据路径、记忆是否创建，以及后续命令。
论文源可见性层级包括：agent-private、author-visible、anonymous-submission、public-preprint、camera-ready-public、publisher-artifact。不同层级对应不同的禁止路径与清理要求，例如公开源需移除 TODO、作者注释、审稿人笔记、内部图表描述与匿名化残留；camera-ready 需去匿名化并补充致谢与资金信息。
错误处理覆盖：非 Git 仓库、脏工作树、分支已存在、工作树路径已存在、沙箱阻止 Git 元数据写入、uv sync 失败、本地无法编译论文等情形。
限制与配合：该技能需与其他技能配合，如 safe-git-ops 处理复杂 Git 状态与沙箱写入失败，research-project-memory 记录工作树用途与退出条件，remote-project-control 用于 SSH/HPC 场景，run-experiment 用于新工作空间立即启动任务，submit-paper 用于投稿、arXiv 或 camera-ready 版本，camera-ready-finalizer 用于已录用版本。若不在 Git 仓库中运行，应先停止并询问目标仓库。本技能未提供关于具体收费、价格或平台支持范围的信息。