shipping-changes

<!-- safety-scan: ignore TOOLS_PRIVILEGED 知识型 skill，仅 Read；文中 git/gh/npm 命令由 agent 自有工具执行，非本 skill 落盘运行 --> # 渡劫之链 · shipping-changes > 大改动不是一锤子。调研定题 → 提案对齐 → 分阶段守卫式推进 → PR 自审 → 补护栏 → 合并。每一关绿了才进下一关。 ## 何时使用 | 场景 | 使用 | 理由 | |------|------|------| | 一个改动牵动多文件 / 多模块 / 公共路径 | ✅ | 回归面大，值得先提案再施工 | | 重构、架构调整、协议/格式变更 | ✅ | 需要写实蓝图 + 字段映射对齐 | | 改动可拆成可独立 revert 的阶段 | ✅ | 守卫链分阶段，控爆炸半径 | | 自审自己的 PR | ✅ | 用挑刺视角找自己埋的雷 | ## 何时不使用 - ❌ 单文件、低风险、机械改动——直接改完跑测试即可，别套流程 - ❌ 纯探索 / 一次性查询——无交付物，不进闭环 - ❌ 紧急止血(宕机/事故)——走故障链「止血→定位→修复→验证→复盘」，不在此列 ## 七关闭环 ``` 关 0 调研定题 —— 摸清现状 + 业界最佳实践，定问题域(不臆造) 关 1 提案文档 —— docs/<topic>.md：诊断 + 蓝图 + 字段映射 + 迁移路径 + 风险回滚 关 2 对齐 —— 魔尊 review 提案；歧义/破坏性/高成本处停下确认 关 3 分阶段实现 —— 每阶段单一关注点、可独立 revert；单点 PoC 绿了再横推 关 4 守卫链提交 —— assert + test + verify 全绿才 commit；任一红即阻断，不提交 关 5 PR 自审 —— 挑刺视角过 diff，把发现挂到 PR 上(含已知取舍) 关 6 补护栏 —— 把自审揪出的隐患钉成测试，follow-up 推上分支 收口 合并 —— 确认 mergeable + CI 全绿 → merge → 同步本地 main ``` ## 核心铁律:守卫链提交(关 4) > 这是全链最值钱的一环——**绝不提交未验证的改动**。 ```bash # 守卫式链:前一步红，后续全部不执行(&& 短路),自然阻断提交 node /tmp/assert.js \ # 自定义不变量断言(如:零宏泄漏、无跨配串味) && npm test \ # 全量测试 && npm run verify:skills \ # 项目专属闸门 && git add -A && git commit -F msg.txt \ && git push -u origin <branch> ``` - **任一关红 → 链断 → 不 commit**：脏改动永不入库。 - **自定义 assert 优先于通用测试**：通用测试覆盖不到的领域不变量,自己写脚本断言(例:渲染产物零模板变量泄漏)。 - **stamp 在链尾**:push / PR 放最后,网络受阻不影响已验证的本地 commit。 > ⚠ **反模式(血泪)**:别把 test 与 commit 塞进同一个 `{ ...; ... }` / `;` 顺序块——块内命令各自独立执行,**test 红了 co...