SuperAPI AI 工具集

work-in-tree

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:在修改任务文件前建立隔离的 Git 检出,并在其中继续完成用户请求的工作,保持原始检出与目标分支不变,直到用户要求同步。

主要能力与流程:

  1. 确定起点:读取仓库说明、Git 状态、分支、HEAD、公共 Git 目录、远程和 git worktree list --porcelain,记录原始检出、目标分支和基础提交。若已在隔离检出中,需通过交接信息、共享元数据或本地反向链接验证原始仓库。默认以当前命名分支为目标,分离检出或目标不明时询问用户。遇到未完成的 Git 操作应停止。保留现有未提交更改,并说明新 worktree 从已提交历史开始。
  2. 复用或创建隔离:仅当 Git 元数据或已验证的本地反向链接证明当前检出已与目标分支隔离时才复用;目标共享引用上的链接 worktree 不算分支隔离。否则创建新任务分支的链接 worktree,遵循仓库分支与位置约定;无约定时使用 worktree/<task-name> 分支和同级目录,避免嵌套在受跟踪项目文件内。创建前确认工作区外路径权限,检查目录与分支是否已存在。命令:git worktree add -b <task-branch> <worktree-path> <base-commit>。随后验证分支、HEAD 和干净状态,并运行仓库规定的初始化。
  3. 仅在任务检出中工作:后续编辑、构建、测试和提交都指向任务检出,使用 git -C <worktree-path> 或显式工作目录。若编辑工具仍指向原始检出,需请用户附加新 worktree 或授权直接编辑。复用现有忽略配置约定,避免凭据进入复制或提交的文件。
  4. 留下返回路径:报告任务检出路径与分支、原始仓库或检出路径、目标分支、基础提交与当前任务提交、未提交更改及验证结果。保留 worktree 供审查和后续工作;同步、上游发布和删除 worktree 需另行请求。

适用场景:用户要求在 worktree 中工作,或需要在不影响原始检出的情况下执行任务。

限制:资料未提供具体平台、收费、价格或效果信息;未提供任务名称时需询问;路径在工作区外需先获授权;未完成的 Git 操作需停止处理。