SuperAPI AI 工具集

worktree

编程与开发

查看项目

更新于 10-15 21:08

技能介绍

用途:解决 git worktree 中缺失的被 gitignore 文件或路径问题。当工作树里缺少主仓库中存在的文件(如配置、密钥目录等)时,该技能会尝试定位并创建符号链接补齐。

主要能力:解析 $ARGUMENTS 中描述的缺失文件或路径(可直接是路径,也可从错误信息中提取,支持空格分隔的多个路径);先做预检,若参数为空或当前不是 worktree 则停止并提示;将路径相对项目根解析并规范化,若路径逃逸出项目根则拒绝操作。

使用方式:先尝试项目安装/构建命令(如 package.json、requirements.txt、Gemfile、go.mod 中的 prepare、postinstall、build 等脚本),若缺失项由此生成则直接成功,无需符号链接;否则从 git worktree list 的第一项(主工作树)定位源文件,确保父目录存在,用 perl 计算相对路径,再用 ln -sfn 创建相对符号链接,最后验证并报告。

适用场景:git worktree 中因 gitignore 而缺失、但主仓库中存在的文件或目录。

限制:不复制文件,只创建符号链接;只使用相对符号链接;不修改主仓库,只在工作树中创建链接;不修改被链接的文件;不运行测试或下游验证;输出保持精简。若缺失项在主仓库中也不存在,则停止并告知用户。