用途：为 Claude Code、Cursor 或 Codex 搭建按 git worktree 独立的开发环境，让每个 worktree 都能自动完成初始化与清理。
主要能力：通过一次交互式提问确定新 worktree 的行为（多选）：复制被忽略的环境变量文件、安装依赖、隔离或初始化数据后端、运行代码生成；并收集项目特有的额外步骤。随后按所选后端（如 PostgreSQL → postgresql.md，Convex → convex.md，无后端则跳过隔离）生成脚本，并只针对所选 IDE（Claude Code、Cursor、Codex）写链接配置。共享逻辑放在 scripts/*.sh，IDE 配置仅指向这些文件。
必要用法：必须生成 scripts/worktree-up.sh、scripts/worktree-down.sh、scripts/dev.sh（均以 .sh 结尾），且要放在源检出目录而不只是当前 worktree。路径解析使用 WORKTREE_PATH="${CODEX_WORKTREE_PATH:-${CURSOR_WORKTREE_PATH:-$(pwd)}}" 与 SOURCE_PATH="${CODEX_SOURCE_TREE_PATH:-${ROOT_WORKTREE_PATH:-}}"。Claude 使用 WorktreeCreate 而非 SessionStart。worktree-up.sh 需幂等，设置 set -euo pipefail 并进入 worktree 后按顺序执行所选步骤：复制环境优先用 .worktreeinclude，根据 lockfile 判断包管理器，资源名从环境、配置或 setup 元数据读取。worktree-down.sh 只清理本套件创建的资源，缺少工具时打印一行并以 0 退出。dev.sh 从 ${DEV_PORT_START:-3910} 选空闲端口，不得硬编码端口。写入前先阅读匹配的 examples/ 文件再改写；后端若无对应文档，需查官方文档与仓库内示例，不可猜测 CLI 参数。写入后用 bash -n 检查三个脚本、执行 git status --short，并在生成 TOML/JSON 时解析校验。
限制与安全：不得提交或记录密钥；不得在 IDE 配置中内嵌多行程序；除非用户设置覆盖环境变量，不得销毁或导入生产数据，导入/回放助手需包含 assert_non_prod_ref 守卫（拒绝 prod、production 等来源，仅当 ALLOW_PROD_SOURCE=1 才放行可疑来源）。是否提供 IDE 界面中的 Dev、类型检查、单测与 lint 入口等细节，资料未完全说明。