菜单
在 Speculo workflow change 内创建隔离 git worktree 进行开发，完成后验证测试并合回基础分支。当用户要求隔离开发、开始实现、或实现完成后需要合并/清理时使用。与 specdev workflow 深度集成，worktree 持久化在 change 目录下的 .worktree/ 中。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
对 workflow 下已完成 change 执行归档移动，从归档 change 中提取知识并合并到 workflow INDEX.md 声明的 _state/ 知识 store（adr/、context/ 等）， 然后审计并清理过时/重复知识。默认 dry-run 返回可确认计划，所有破坏性动作需用户显式确认后执行。 触发场景：workflow 中存在 change_status: completed 的 change 需要归档收尾、知识沉淀、清理过时内容时。
构建一个一次性原型来回答设计问题。当用户想要快速验证某个状态模型或逻辑是否正确，或探索 UI 应该长什么样时使用。
将 Speculo 多文件能力（skill/command/workflow）合并为自包含单 MD 文档，上传到网页 AI 平台（ChatGPT Projects、Claude Projects、NotebookLM）使用。触发：用户要求生成 canonical 文档、要求将能力打包为单文件、或要求上传能力到 AI 平台时。
创建、审计、合并或迁移 Speculo 的可复用 skill。用户要求新增 template/skills 能力、清理 SKILL.md、整合相似 skills、迁移外部 skill 或修复渐进披露时使用。
在指定 workflow 中撰写单个 work 入口文件（X-name/X-name.md）及其渐进披露子文件。用户指定 workflow 和 work 名称，要求新增 work、为已有 work 补充子文件、重构 work 步骤结构、优化完成标准、对齐主导词或修复 <Path> 指针时使用。
在指定 workflow 包中新增、审计或合并 work 入口。用户指定 workflow 名称（如 template/workflows/person）并要求新增具体 work、审计现有 work 的渐进披露结构、合并相似 work、基于参考材料生成 work 或对齐 <Path> 路径引用格式时使用。
| name | dev-worktree |
| description | 在 Speculo workflow change 内创建隔离 git worktree 进行开发，完成后验证测试并合回基础分支。当用户要求隔离开发、开始实现、或实现完成后需要合并/清理时使用。与 specdev workflow 深度集成，worktree 持久化在 change 目录下的 .worktree/ 中。 |
为当前 workflow change 创建独立 worktree，实现「隔离开发 → 验证 → 合并 → 清理」闭环。
启动时宣布： 「正在使用 dev-worktree 技能。」
| 场景 | 入口 |
|---|---|
| 要开始实现 / 用户要求隔离 | 阶段 A：创建 worktree |
| 已在 worktree 中，开发完成 | 阶段 B：收尾合并 |
| 已在 worktree 中，未完成 | 继续开发，不重复创建 |
| 用户要求 PR / 暂存 / 丢弃 | 阶段 B 按对应选项执行 |
详细步骤见 references/create.md。核心流程：
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)
SUPER=$(git rev-parse --show-superproject-working-tree 2>/dev/null)
SUPER 有值 → submodule 内，按普通仓库处理，不误判GIT_DIR != GIT_COMMON 且非 submodule → 已在 worktree，跳到 A3 设置GIT_DIR == GIT_COMMON → 主工作区，继续| 要素 | 值 |
|---|---|
| 基础分支 | 当前分支（git rev-parse --abbrev-ref HEAD） |
| change 分支 | speculo/<workflow>/<change> |
| worktree 路径 | {state-root}/<workflow>/changes/<change>/.worktree/ |
分支或路径已存在 → 停止，不覆盖不复用。
前置检查： speculo/.speculo/ 必须被 git 跟踪——产物需随分支合并。若被忽略则降级为非 worktree 模式。
git worktree add -b speculo/<workflow>/<change> {state-root}/<workflow>/changes/<change>/.worktree
确保 .gitignore 含 .worktree/；缺失则追加并提交。
自动检测并安装依赖、运行基线测试：
[ -f package.json ] && (npm install 2>/dev/null || true)
[ -f Cargo.toml ] && cargo build
[ -f requirements.txt ] && pip install -r requirements.txt
[ -f go.mod ] && go mod download
# 跑基线测试
基线测试失败 → 报告并询问，未获许可不开始实现。
将 base_branch、change_branch、worktree_path、worktree_status: active 写入 change 的 .status.json。
详细步骤见 references/finalize.md。
跑项目测试套件。失败 → 停止，禁止合并/PR。
实现已完成。你想怎么做？
1. 本地合并回 <base-branch>（推荐，默认）
2. 推送并创建 Pull Request
3. 保持现状（稍后处理）
4. 丢弃
选哪个？
分离 HEAD 时移除选项 1。用户未指定时默认选项 1。
选项 1（本地合并）：
git checkout <base> && git pull && git merge --no-ff <change_branch>git worktree remove <path>git branch -d <change_branch>git worktree prune.status.json：worktree_status: removed选项 2（PR）： 推送分支、创建 PR，保留 worktree。 选项 3（保持）： 不动，报告状态。 选项 4（丢弃）： 确认后删除 worktree 和分支。
合并冲突或测试失败 → 停止，保留现场，报告原因，不强推。
绝不：
git worktree remove始终：
speculo/<workflow>/<change>.worktree/git worktree prune