这是面向 Jean(coollabsio/jean,按 agent 分配 worktree 的开发环境)的仓库接入 skill。用途是把一个仓库的 worktree 引导流程(安装、运行、端口、销毁)写成自动化清单,并证明它可零手工步骤跑通。
主要能力:探查仓库中必需但被 gitignore 的文件、安装命令、dev 运行命令、监听端口、遗留进程,再据此生成 jean.json 与 .worktreeinclude。.worktreeinclude 是声明,jean.json 的 setup 是执行者;Jean 本身不读取 .worktreeinclude,setup 脚本需用 $JEAN_ROOT_PATH 自行复制文件,两者需保持同步。小配置文件用 cp,大依赖目录可用 COW(如 cp -Rc)克隆或依赖 store 安装跳过;不要跨 worktree 软链 node_modules。
用法:分阶段执行。先读 .gitignore、package.json 等做证据盘点;再按 references/jean-json-spec.md 与 templates.md 起草;然后创建一次性 worktree 并模拟 Jean 的执行环境(登录 shell、cwd 为 worktree、设置 JEAN_WORKSPACE_PATH、JEAN_ROOT_PATH、JEAN_BRANCH)验证 setup 退出码、复制结果、端口可访问、teardown 可重复执行;通过后提交文件并在 AGENTS.md 记录手工等价步骤;最后删除测试 worktree 与分支并确认无残留。
限制与规则:未经新 worktree 实测不得声称完成;不留下测试 worktree 或分支;jean.json 与 .worktreeinclude 必须被 git 跟踪;setup 脚本须幂等且非交互;破坏性命令需用 Jean 校验的环境变量做前缀守卫;已存在 jean.json 时只做差分改进。仓库不使用 worktree 时不应使用本 skill。具体模板、端口策略与优化细节见其 references 文件。