SuperAPI AI 工具集

worktree-guide

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:为 Git worktree 工作流提供速查参考与模板,并结合 AI 元数据帮助工具理解上下文。

主要能力:

  1. 命令入口:创建 /working-tree:new <branch-name>、列出 /working-tree:list、查看状态 /working-tree:status、删除 /working-tree:destroy <path>、为已有 worktree 添加元数据 /working-tree:adopt。
  2. 模式语义,含 main(稳定生产代码,最小改动)、feature(新功能开发,鼓励实验)、bugfix(隔离修复,限制范围)、experiment(原型与调研,可丢弃)、review(评审与审计,只读分析)。
  3. 元数据:.ai-context.json 包含 worktree、branch、mode、created、description 字段;创建时自动生成 README.working-tree.md。
  4. 模板与参考:templates/ 目录含 ai-context.json.template 与 README.working-tree.template;references/best-practices.md 提供命名规范、工作流与多 worktree 组织策略。

使用方式:按上列命令创建或管理 worktree,可附带 --mode 与 --description 参数,例如 /working-tree:new feature/user-auth --mode feature --description "Implement OAuth2"。

适用场景:功能开发、生产热修、实验验证、代码评审、国际化等需要隔离分支的工作。

限制与注意事项:不要为同一分支重复创建 worktree;避免使用 test、temp、new 等泛化名称;不要使用与现有项目目录重名的分支名;删除前确认未提交更改;完成后及时用 /working-tree:destroy 清理。复杂组织问题可调用 working-tree-consultant 代理。具体收费、平台支持等信息暂未提供。