用途:该技能是 gw-tools 的配置管理指南,帮助用户为不同项目类型和团队需求配置并优化 gw 工作流。
主要能力:讲解 gw 配置机制,配置文件位于仓库内的 .gw/config.json,按仓库而非全局生效,并在该仓库所有 worktree 间共享。核心配置项包括 root(包含所有 worktree 的父目录绝对路径)、defaultBranch(默认源 worktree,如 main、master、develop)、autoCopyFiles(创建 worktree 时自动复制的文件或目录列表)。
使用方式:多数情况可用自动检测,执行 gw init 自动识别仓库根目录与默认分支并生成配置;自动检测失败时可手动指定,例如 gw init --root /projects/myapp.git --default-branch main --auto-copy-files .env,.env.local,secrets/。创建 worktree 时用 gw add feature-x,同步文件用 gw sync target file.txt,可用 --from 覆盖默认来源。
适用场景:资料给出 Next.js、Node.js API、React SPA、Monorepo、全栈应用等配置模板,建议自动复制 .env 系列、secrets/、ssl/、本地配置等,不建议复制 node_modules、构建产物等。团队可将 .gw/config.json 提交到版本库统一配置,个人文件可放入 .gitignore 的本地配置。
限制:目前不支持 glob 模式(如 *.env),需显式列出文件或复制父目录;路径须相对仓库根目录,目录以 / 结尾;文件为复制而非符号链接,不存在的文件会跳过并警告。具体命令与配置以官方资料为准。