本地改动 → 选择性提交 → 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 时:
- 创建 MR/PR:source=当前分支,target=目标分支,title 一句话概括"做了啥"
- 等
merge_status从checking→can_be_merged(一般 5-15 秒) - 合并;记下 merge commit SHA,后面给 CI 对账用
- 不要自动 remove source branch,除非用户明说
无 MCP 时:把 MR URL 输出给用户,请其完成合并后回告 merge SHA。
4. 触发 CI 构建
有 Jenkins MCP 时:
- 列 jobs / 分页搜索,按
这类命名规律找到目标 job_ getBuild看上一次成功构建的参数集 —— 直接照抄参数名和取值惯例(如branch=refs/heads/),不要自己造参数triggerBuild;返回 HTTP 201 才算入队成功- 轮询
getBuild直到building: false;校验result == "SUCCESS" - 用
lastBuiltRevision.SHA1核对等于第 3 步的 merge SHA,确认 CI 拉到的就是这次合并的代码
多 service 并行:边/云、多微服务都要部署时,所有 triggerBuild 在同一消息里并行触发;轮询时也并行查。
轮询节奏:先 sleep ~30s,之后参考 estimatedDuration 与上次 build duration 估时长,指数回退(30s → 60s → 120s → 180s)。
5. 重启工作负载
有 Kubernetes MCP 时:
- 找 namespace、按 label selector 定位 pod
- 优先:
pods_delete删 pod 让 RS 拉新,前提用pods_get确认imagePullPolicy: Always且 image tag 不变 - 次选:如果 tag immutable 或走 helm/argocd 通道,引导用户用对应通道
- 等新 pod
READY=N/N全就绪、旧 podTerminating完成
关键检查:
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 类场景:
- 正向新增 — 创建一条记录,API 响应 + DB SELECT 都断言
- 幂等 / upsert — 相同 key 二次调用,验 id 不变、
updated_*变、created_*保留 - 守卫 / 校验失败 — 构造非法输入,期望业务错误码而非 panic
- 副作用链 — A 操作要触发 B 系统状态变化,从 B 这边再断言一遍(典型:A→B 同步、B→A 反向调用)
测试数据可清理:
- 用一眼能认出的前缀(如
E2E001/E2E-),不要用真实业务样子的 key-001 - 测完调对应 delete 接口或 SQL 把数据复位
- 如果中途清空 / 改写了共享或生产数据,必须先 SELECT 备份原值,测完用 SQL 恢复
断言强度:
- 不能"HTTP 200 就算过" ——
effectCount=0也是 200 - 不能只看 service 日志没报错 —— 没记录 ≠ 没问题
- 关键路径要有 DB 端的 evidence
7. 失败 → 补丁再循环
测试不过 / 部署失败 / pod 起不来时:
- 抓证据:
pods_log(带上下文窗)、getBuild失败 stage、DB 查询、关键事件 - 把错误定位到层:代码层 / 配置层 / 数据层 / 网络层。不靠猜直接动代码
- 定位后仅提交修复相关的文件(重走第 1 步规则,严守"只 add 相关文件")
- 不要
--amend已 push 的 commit;新建fix: <原因简述>commit - 回到第 2 步开始下一轮闭环
全程铁律
- 只提交本次任务相关的文件。一发现 untracked/modified 不属于本次,跳过它
- 每一步等真完成再进下一步:MR
merged才触 CI;CISUCCESS才动 pod;podReady才开测 - 三方 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工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习
最新文章