Ship（发布阶段 · 路由）

来源：addyosmani/agent-skills v0.6.9 的 git-workflow-and-versioning / ci-cd-and-automation / observability-and-instrumentation / documentation-and-adrs / deprecation-and-migration / shipping-and-launch。 本文件是路由层，六份原文都是本技能目录下的子文件，用 read 按相对路径读取。

这个阶段干什么

把通过 review 的改动安全送上生产。 收尾动作：原子提交 → CI 跑过 → 文档 + 观测 → 让人跑一次端到端 → 正式发布。

⚠️ 全程唯一一次人工验证在这里：所有 diff 影响面、L3 机器判定都过了之后， 人跑一次端到端（见 verify 的"浏览器验证 / 主观判断"那条）。 这一步只能人做 —— 不要假装跑了。

路由表

上线主流程

1. 读 git-workflow-and-versioning.md        → 原子 commit + 干净历史
2. 读 ci-cd-and-automation.md             → 每次改动自动门禁
3. 读 observability-and-instrumentation.md → 日志 / 指标 / 追踪 / 告警
4. 读 documentation-and-adrs.md            → 写「为什么」不只是「是什么」
5. （如果是下线/迁移）deprecation-and-migration.md
6. shipping-and-launch.md                 → 上线清单 + 监控 + 回滚
7. 交付前门禁（见 verify 与 build）—— 人跑一次端到端
8. 发布

不是每步都要走。 一个内部 CLI 工具 → 大概只需要 1 + 2 + 6。 一个面向用户的 API → 1 + 2 + 3 + 4 + 6 + 7。

边界

做：原子提交、走 CI、加观测、写文档、设回滚、人跑端到端、发布。

不做：

• ❌ 不写新的功能代码 —— 那是 build
• ❌ 不替人做主观验收 —— 那是 verify + 人（端到端那一次）
• ❌ 不跳过端到端 —— 即便所有自动化都过；「全绿 ≠ 用户能用对」

★ 共享纪律见 meta。本阶段最吃重的是 「守门而不是冲」 —— 任何看起来「已经可以了」的判断都要被端到端 + 回滚计划拦住。