Worktree Doctor 用于分析仓库并给出 .worktreeinclude 建议，使新建 worktree 能继承所需的本地文件（环境变量、密钥、本地配置）。因为普通的 git worktree add 以及封装它的 git-worktree 技能只会复制同时被 gitignore 且列在 .worktreeinclude 中的文件。它常与 /git-worktree 配合使用，后者负责创建 worktree 并执行复制。
适用场景：在新仓库中设置 worktree、首次运行 /git-worktree 之前；某个 worktree 缺少 .env 或本地设置；想确认 .claude/worktrees/ 是否已被 gitignore。
用法：默认只输出建议、不做改动：uv run "${CLAUDE_SKILL_DIR}/scripts/worktree_doctor.py"；如选择写入文件（不会覆盖已有的 .worktreeinclude）：uv run "${CLAUDE_SKILL_DIR}/scripts/worktree_doctor.py" --write。也可用 /worktree-doctor 或 /worktree-doctor --write 调用。
脚本会：列出被 gitignore 的文件并标出 env/密钥/本地配置候选（跳过 .venv、node_modules 等 vendored 路径）；检测项目类型（pyproject.toml、package.json、Cargo.toml、go.mod）；报告 .claude/worktrees/ 是否被 gitignore；打印建议的 .worktreeinclude。采用前应先审阅建议，可参考 references/worktreeinclude-patterns.md 了解各模式含义及为何排除 vendored 路径。
关于密钥：该工具从不读取文件内容，只读取路径。.env / .envrc 含密钥，切勿打印或记录；.envrc 是 Claude 的受保护路径。具体安装与运行前的其他依赖条件暂未提供。