用途:协调跨多个仓库的重构。编排会话读取变更描述、规划各仓库编辑、按仓库派生 subagent 执行,将结果落到各仓库同一命名模式的特性分支并推送供审查。配套的 branch-guard 钩子负责阻止推送至 main/master/develop 及任何已存在分支。
适用场景:重构需在 3 个以上仓库协调改动(如共享库升级加下游消费方更新);改动是机械或系统性的,各仓库无需新设计决策;希望 agent 无人值守完成。不适用:只涉及单仓库;各仓库需要不同设计决策;新形态尚未确定(应先在一个仓库探索)。
使用方式:先确认所有目标仓库工作区干净。向 Claude 提供变更描述、仓库列表及(如相关)需查找的符号/文件模式,并要求“Run cross-repo-refactor in cook mode for <repos>. Slug: <short-slug>. Description: <one-liner>.”。编排会话生成 <short-sha>,逐仓库派生 subagent:运行 git checkout -b cook/refactor-<slug>-<short-sha>;编辑;以结构化消息提交 refactor(<slug>): <one-line summary>;执行 git push -u origin cook/refactor-<slug>-<short-sha>。最后收集各仓库分支 URL 并写入单条汇总消息。
分支命名:cook/refactor-<slug>-<short-sha>。<slug> 为 kebab-case、字母数字加连字符、不超过 30 字符;<short-sha> 至少 7 位十六进制字符。钩子正则为 ^cook/refactor-[a-z0-9-]+-[0-9a-f]{7,}$。不匹配的分支在 checkout -b 时被拒绝,向 main/master/develop 的推送及 HEAD:main refspec 推送也被拒绝。
终止条件:各目标仓库均有符合命名模式的分支;各分支包含以结构化消息提交的编辑;各分支已成功推送至 origin;编排会话已输出列出各仓库分支 URL 的汇总(或给出清晰失败说明);cooking 标记文件被移除。触发时执行 rm -f ~/.claude/cooking/active-$PID ~/.claude/cooking/iter-$PID。若第 10 次迭代仍未完成扩散,写部分进展说明并退出,不得为“跑通”跳过结构化消息格式。
限制与注意事项:不要推送 main;不要复用已存在分支;不要将多个无关重构合并在一个 slug 下;不要在会话中修改 hooks/cooking/branch-guard.sh 放宽限制。branch-guard 钩子依赖 Claude Code 的 PreToolUse Bash matcher,Cursor 目前无等价的 PreToolUse Bash 钩子,因此在 Cursor 下仅为技能文字约束、无运行时守卫,重要时应在 Claude Code 中使用,或在推送前人工审查分支名。验证脚本 bash hooks/cooking/test/branch-guard.sh 覆盖 11 个用例。原文未提供收费、平台支持等其它信息。