用途：在隔离的 Git worktree 中自主完成一个功能或修复的完整开发周期，从任务接收、规划、实现、测试到创建草稿 PR，并按需清理 worktree。适合希望让 AI 按固定阶段推进、保留可追溯计划的开发场景。
主要能力：预先强制检测工作流模式——Full 模式（4 个以上文件或复杂/架构性改动）或 Lite 模式（1-3 个文件且简单），不确定时选 Full。Full 模式生成两个产物，放在 .gw/{branch-name}/ 下：plan.md（实现策略、决策、进度日志，Phase 2 创建）和 walkthrough.md（最终交付总结，Phase 6 创建），均为 gitignore 并按分支分组。流程共 7 个阶段：Phase 0 需求验证、Phase 1 规划（先在对话中准备内容）、Phase 2 worktree 设置、Phase 3 增量实现、Phase 4 测试迭代、Phase 5 文档更新、Phase 6 创建草稿 PR、Phase 7 可选清理。测试阶段采用快速迭代循环，迭代过多会告警和停止。
必要用法：先确认 gw 是否安装，命令为 which gw。未安装时先安装：npm install -g @gw-tools/gw，或 brew install mthines/gw-tools/gw，或 pnpm add -g @gw-tools/gw。随后设置 shell 集成，如 echo 'eval "$(gw install-shell)"' >> ~/.zshrc 并 source ~/.zshrc（bash 用 ~/.bashrc）。验证安装用 gw --version 和 gw --help，然后在仓库初始化：gw init 或 gw init --auto-copy-files .env,secrets/ --post-checkout "npm install"。Full 模式在 gw add feat/feature-name 后于 worktree 内创建并填充 plan.md，最后 gh pr create --draft；清理用 gw remove feat/feature-name。可选安装 agent 与路由规则模板以支持自动触发。
限制：资料明确要求不得在主分支创建产物文件；plan.md 必须详尽到新会话可独立执行；Phase 0 与 Phase 2 不可跳过。未提供收费、平台支持范围、实际效果等事实。