讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

merge-deploy-verify-loop

Polar Sponsor
爱发电 赞助
.NET 9.0

本地改动 → 选择性提交 → push → 合并目标分支 → CI 构建部署 → 重启工作负载 → 端到端功能/数据库验证 → 失败则补丁循环的完整发布 SOP。

Merge / Deploy / Verify Loop

功能概述

Merge / Deploy / Verify Loop是一项面向实际任务的技能,主要用于把"本地已 ready 的改动"安全送到目标环境并完成验证闭环的通用流程;不绑定具体项目、具体分支命名、具体 MCP 实现;

核心要点

  • 用户意图涉及以下任一项时按本 SOP 走:;
  • 把改动 合并到 develop / feature/ 分支 *并部署;
  • 用 CI(Jenkins 等) 触发构建,再 重启 pod / 滚动更新;

使用与执行

部署完成后。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;

结果检查与注意事项

若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

Merge / Deploy / Verify Loop

把"本地已 ready 的改动"安全送到目标环境并完成验证闭环的通用流程。不绑定具体项目、具体分支命名、具体 MCP 实现。

何时启动

用户意图涉及以下任一项时按本 SOP 走:

  • 把改动合并到 develop / feature/ 分支*并部署
  • 用 CI(Jenkins 等) 触发构建,再重启 pod / 滚动更新
  • 部署完成后端到端验证接口 + 数据库
  • 验证失败 → 定位 → 仅提交补丁 → 再循环一次
  • "走一遍发布闭环 / 完整链路 / to dev"

七步闭环

Task Progress:
- [ ] 1. 选择性暂存 - 只 add 本次相关的改动
- [ ] 2. Commit + Push
- [ ] 3. 合并到目标分支(MR)
- [ ] 4. 触发 CI 构建
- [ ] 5. 重启工作负载
- [ ] 6. 端到端验证
- [ ] 7. 若 6 失败 → 仅提交补丁 → 回到 2

1. 选择性暂存

铁律:永远只 git add 单文件清单。禁止 git add -A / git add . / git commit -am。

git status 先全量列出变更,对每个文件单独判断"是否属于本次任务":

必须排除 理由
本地调试改动(config 指向 localhost / 自己机器路径) 推上去会让 CI/同事炸
.idea/ .vscode/ *.exe *.log 等 IDE/构建产物 该走 .gitignore
含密钥、token、私钥的文件 安全事故
别人未关联本次任务的 in-flight 改动 偷带

判定不明时:用 AskQuestion 让用户拍板,不要替用户决定。

暂存后用 git status --short 复核:M 前空格=已 staged, M=未 staged。

2. Commit + Push

  • commit message 用 HEREDOC,遵循项目历史 commit 风格(先 git log --oneline -10 看一下)
  • 不修改 git config
  • 不 --amend 已经 push 过的 commit;不 --no-verify
  • git push origin HEAD

3. 合并到目标分支

目标分支优先级:用户明说的 > 项目默认分支 > 询问用户。不要猜 main / master。

有 GitLab/GitHub MCP 时:

  1. 创建 MR/PR:source=当前分支,target=目标分支,title 一句话概括"做了啥"
  2. 等 merge_status 从 checking → can_be_merged(一般 5-15 秒)
  3. 合并;记下 merge commit SHA,后面给 CI 对账用
  4. 不要自动 remove source branch,除非用户明说

无 MCP 时:把 MR URL 输出给用户,请其完成合并后回告 merge SHA。

4. 触发 CI 构建

有 Jenkins MCP 时:

  1. 列 jobs / 分页搜索,按 _ 这类命名规律找到目标 job
  2. getBuild 看上一次成功构建的参数集 —— 直接照抄参数名和取值惯例(如 branch=refs/heads/),不要自己造参数
  3. triggerBuild;返回 HTTP 201 才算入队成功
  4. 轮询 getBuild 直到 building: false;校验 result == "SUCCESS"
  5. 用 lastBuiltRevision.SHA1 核对等于第 3 步的 merge SHA,确认 CI 拉到的就是这次合并的代码

多 service 并行:边/云、多微服务都要部署时,所有 triggerBuild 在同一消息里并行触发;轮询时也并行查。

轮询节奏:先 sleep ~30s,之后参考 estimatedDuration 与上次 build duration 估时长,指数回退(30s → 60s → 120s → 180s)。

5. 重启工作负载

有 Kubernetes MCP 时:

  1. 找 namespace、按 label selector 定位 pod
  2. 优先:pods_delete 删 pod 让 RS 拉新,前提用 pods_get 确认 imagePullPolicy: Always 且 image tag 不变
  3. 次选:如果 tag immutable 或走 helm/argocd 通道,引导用户用对应通道
  4. 等新 pod READY=N/N 全就绪、旧 pod Terminating 完成

关键检查:

  • imagePullPolicy 必须 Always;IfNotPresent + 不变 tag = 用本地缓存的旧 image,等于没部署
  • 多容器 pod 必须等所有容器 ready 再进第 6 步,readinessProbe 未过时打过去都不算数

6. 端到端验证

覆盖原则:每个新增/改动的接口都要被实际打到,每个落库字段都要被 SELECT 确认。

按权限差异分层选工具:

通道 工具 何时用
不要 token 的内部接口 K8s pods_exec + curl localhost: 后端到后端互调(如内部 sync/health/admin)
要 token 的外部接口 用户提供 token + Fetch MCP / shell curl 完整模拟前端用户视角
数据库断言 对应 DB 的 MCP,或 pods_exec 进 DB pod 执行 psql/mysql 任何"已落库"断言
路由生效验证 pods_log 看启动日志里的路由列表 / "Total: N routes" 确认新代码已部署

最少覆盖的 4 类场景:

  1. 正向新增 — 创建一条记录,API 响应 + DB SELECT 都断言
  2. 幂等 / upsert — 相同 key 二次调用,验 id 不变、updated_* 变、created_* 保留
  3. 守卫 / 校验失败 — 构造非法输入,期望业务错误码而非 panic
  4. 副作用链 — A 操作要触发 B 系统状态变化,从 B 这边再断言一遍(典型:A→B 同步、B→A 反向调用)

测试数据可清理:

  • 用一眼能认出的前缀(如 E2E001 / E2E--001),不要用真实业务样子的 key
  • 测完调对应 delete 接口或 SQL 把数据复位
  • 如果中途清空 / 改写了共享或生产数据,必须先 SELECT 备份原值,测完用 SQL 恢复

断言强度:

  • 不能"HTTP 200 就算过" —— effectCount=0 也是 200
  • 不能只看 service 日志没报错 —— 没记录 ≠ 没问题
  • 关键路径要有 DB 端的 evidence

7. 失败 → 补丁再循环

测试不过 / 部署失败 / pod 起不来时:

  1. 抓证据:pods_log(带上下文窗)、getBuild 失败 stage、DB 查询、关键事件
  2. 把错误定位到层:代码层 / 配置层 / 数据层 / 网络层。不靠猜直接动代码
  3. 定位后仅提交修复相关的文件(重走第 1 步规则,严守"只 add 相关文件")
  4. 不要 --amend 已 push 的 commit;新建 fix: <原因简述> commit
  5. 回到第 2 步开始下一轮闭环

全程铁律

  • 只提交本次任务相关的文件。一发现 untracked/modified 不属于本次,跳过它
  • 每一步等真完成再进下一步:MR merged 才触 CI;CI SUCCESS 才动 pod;pod Ready 才开测
  • 三方 SHA 对账:commit SHA → merge SHA → CI 拉的 SHA。任何一处对不上立刻停下查
  • 共享数据先备份后改,测完恢复
  • 不静默吞错:哪怕"看上去通了"也要至少一条 SQL/HTTP 响应作证据
  • 破坏性操作(force push、删 prod pod、大范围 DELETE)必须先和用户确认
  • 不替用户做模糊决策;模糊处用 AskQuestion

输出对账表

每轮闭环结束给一份对账,让用户一眼能复核:

| 阶段 | 状态 | 关键凭证 |
|---|---|---|
| Commit | ✅ |  |
| Merge | ✅ | MR #X,merge commit  |
| Build A | ✅ | job #N SUCCESS,拉取 SHA = merge SHA ✅ |
| Build B | ✅ | job #M SUCCESS,拉取 SHA = merge SHA ✅ |
| Restart | ✅ | 新 pod Ready N/N,旧 pod 已 Terminating |
| Test 1..K | ✅ K/K | 见下方明细 |

后接每个测试场景的 HTTP 状态码、effectCount、DB SELECT 结果。

反模式

  • ❌ git add . / git commit -am — 容易把 IDE 配置、本地调试、别人改动一起推
  • ❌ 触 CI 后立刻去测 — 镜像还没构建完
  • ❌ 删 pod 后立刻测 — 容器还没起或 readinessProbe 未过
  • ❌ 只看 HTTP 200 不查 DB — effectCount=0 也是 200
  • ❌ pods_log 取最后 20 行做断言 — ERROR 刷屏的服务关键日志会被冲掉,改成按时间窗 / grep 关键词
  • ❌ 测完不恢复共享 / 生产数据 — 留给下个同事一个雷
  • ❌ Build 失败 / hook 失败就 --amend — 历史被改还要 force push;正确做法是新 commit
  • ❌ 没拿到 merge SHA 就开始触 CI — 没法核对 CI 是不是拉到本次代码
  • ❌ 直接用本地默认分支 main / master 当目标 — 不同项目流派不同,必须问

与其他 SKILL 的边界

  • 上游:开发阶段的需求拆解、设计、测试用例编写,参考更顶层的 cursor-self-bootstrap-workflow
  • 平行:远程日志分析参考 server-log-analysis;复杂 bug 多轮排查参考 complex-bug-debugging-with-ai
  • 本 SKILL 只负责"代码已 ready 之后到生效验证"这段,不掺合代码怎么写
目录

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn