用途:该技能为 delta-claude 仓库定义一套变更合入与发布流程,覆盖两条长期分支。develop 是主干,所有变更先合入这里;通过 zed-industries/delta-claude#develop 添加 marketplace 的安装会从 develop 更新。main 是稳定分支和默认分支,通过 zed-industries/delta-claude 添加 marketplace 的安装会从 main 更新;main 只前进到已经存在于 develop 的提交,hotfix 除外。Claude Code 没有独立发布通道,每次安装跟随添加 marketplace 时所在的分支,并且只有当 .claude-plugin/plugin.json 中的 version 变化时才更新。
权限要求:未经用户明确、直接许可,不得修改 develop 或 main。这包括 gh pr merge、auto-merge、直接 push 或任何更新分支的 API 调用。合入 develop 与发布到 main 是两种独立权限;获得合入许可不代表获得发布许可,发布许可需要指明要发布的 develop 提交。实现请求、推送分支、打开 PR 或检查 CI 都不构成许可,CI 通过也不构成许可。仅在用户明确要求 land、merge 或 release 指定变更时才视为许可,例如“CI 通过后就合入”。若许可后变更发生实质变化,需重新请求许可。
提交准备:用户可感知的变更需在 release-notes/ 下新增 YYYY-MM-DD-<topic>.md,并标注 Added、Improved 或 Fixed 分类。已安装插件应感知的变更需提升 .claude-plugin/plugin.json 中的 version;版本号必须高于任一分支付使用过的所有版本,且不能复用其他提交已使用的版本。将分支 rebase 到当前 origin/develop 并压缩为单个提交;CI 只测试分支头,因此进入 develop 的每个提交都必须经过 CI 测试。提交信息是变更的唯一描述:简短祈使句标题后,用几段短文说明动机、先前行为和解决方式;写入文件并通过 git commit -F 提交。共享线程时,结尾附上其分享 URL,格式为 Delta-Thread: https://delta.dev/join/thread_...。
推送与等待 CI:每次分支推送都会运行 CI。示例命令包括 git push -u origin HEAD、获取 HEAD 的 sha、用 gh run list 查询该提交的 CI 运行、用 gh run watch --exit-status 等待结果。应向参与者提供运行 URL。小型且明确的失败可自行修复并再次推送;疑似不稳定、与变更无关或需要产品决策的失败应停止并报告。
将已测试提交放到 develop:再次确认许可,确认该确切提交的 CI Pass 成功,然后推送。示例先用 gh api 查询提交状态并筛选 context 为 CI Pass 的 state,再执行 git push origin "$sha:refs/heads/develop"。该推送需要组织成员身份;否则会被拒绝,此时应针对 develop 打开 PR 并在 CI Pass 绿后 squash-merge;GitHub 默认 PR 基为 main,需改为 develop。若 develop 已移动,推送会因 non-fast-forward 被拒;应 rebase 到新的 origin/develop、推送分支、等待 rebase 后提交的 CI,再推送该提交。绝不把未通过 CI 的提交推送到 develop。
清理:删除远程分支、切换到 develop、git pull --ff-only origin develop、删除本地分支。若清理步骤失败,应报告而不是强制操作,因为变更已经合入。
发布 develop 到 main:发布是将 main 快进到某个 develop 提交,该提交保留在 develop 上获得的 CI Pass 状态,因此发布无需新的 CI 运行,也不会创建提交。选择要发布的 develop 提交(通常是 origin/develop 的头),并获得发布该提交的许可。检查本次发布必须兼容的每个 Delta CLI 构建都能记录,包括当前稳定构建;该提交的 hooks/cli/thread-commands.ts 中 CLI 线程契约必须报告至少为 PLUGIN_CONTRACT_MIN 的最大值,否则插件会以“This Delta is too old for this plugin”拒绝记录,此时应推迟发布直到该 CLI 构建发布。确认 CI Pass 且 main 可快进后推送:git fetch origin develop main,验证该 sha 是 origin/develop 的祖先、origin/main 是该 sha 的祖先、查询 CI Pass 状态,再执行 git push origin "$sha:refs/heads/main"。若 main 不能快进到该提交,说明 main 上的 hotfix 尚未合回 develop,需先按下述方式合回。
Hotfix main:当稳定分支需要无法等待 develop 可发布的修复时,从 origin/main 拉分支,按步骤 1 和 2 修复并测试,版本号高于任一分支付使用过的所有版本。获得 hotfix main 许可后,按步骤 3 将已测试提交推送到 main(以 main 替代 develop)。然后从 origin/develop 拉分支,用 merge commit(而非 rebase 或 cherry-pick)合并 origin/main,以便下次发布仍能快进;合并时再次提升版本,因为合并后的树与两个父提交都不同。推送分支、等待 CI,并按步骤 3 将合并提交合入 develop。若 develop 已移动,应在新的 origin/develop 上重做合并,而不是 rebase。