Menu
在 Speculo workflow change 内创建隔离 git worktree 进行开发，完成后验证测试并合回基础分支。当用户要求隔离开发、开始实现、或实现完成后需要合并/清理时使用。与 specdev workflow 深度集成，worktree 持久化在 change 目录下的 .worktree/ 中。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
对 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