Shipping Changes

This is the workflow skeleton for landing substantial changes without blowing things up. It walks you through research, writing a proposal doc, implementing in reversible phases, and self-reviewing your PR before merge. The core discipline is the guarded commit chain: assertions, tests, and verification all have to pass before anything gets committed, using shell && short-circuiting so a single failure blocks the commit entirely. It includes impact analysis checks if you have abyss available, and pushes you to honestly flag known tradeoffs in your self-review rather than hiding them. Use it when a change is big enough to warrant a written plan, or when you want to ship risky work in rollback-friendly stages. For small, low-risk edits, skip the ceremony and just ship.

GitHub stars: 224
last updated: Jun 10, 2026

View on GitHub

Install

$ npx -y skills add telagod/code-abyss --skill shipping-changes --agent claude-code

Installs into .claude/skills of the current project.

Files

渡劫之链 · 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