用途:为 Git worktree 工作流提供速查参考与模板,并结合 AI 元数据帮助工具理解上下文。
主要能力:
- 命令入口:创建 /working-tree:new <branch-name>、列出 /working-tree:list、查看状态 /working-tree:status、删除 /working-tree:destroy <path>、为已有 worktree 添加元数据 /working-tree:adopt。
- 模式语义,含 main(稳定生产代码,最小改动)、feature(新功能开发,鼓励实验)、bugfix(隔离修复,限制范围)、experiment(原型与调研,可丢弃)、review(评审与审计,只读分析)。
- 元数据:.ai-context.json 包含 worktree、branch、mode、created、description 字段;创建时自动生成 README.working-tree.md。
- 模板与参考: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 代理。具体收费、平台支持等信息暂未提供。