shipping-and-launch skill 是什麼、怎麼安裝使用：上線前檢查清單、灰度放量閾值和回滾策略

本文根據 addyosmani/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 addyosmani/agent-skills 在 GitHub 約 10.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

「代碼寫完了」和「可以上線了」之間隔着一長串事情，獨立開發者和小團隊最容易在這裏漏項。shipping-and-launch 把這串事情列成清單交給智能體。description：為生產發佈做準備；在準備部署到生產環境、想知道上線前要具備什麼、需要上線前檢查清單、搭建監控、規劃分階段放量或需要回滾策略時使用。SKILL.md 的立場是：每次發佈都應該可回退、可觀測、漸進進行。

上線前清單分六類：

• 代碼質素——測試全過、構建無警告、檢查與類型校驗通過、代碼已評審、沒有遺留的調試輸出；
• 安全——代碼和版本庫裏沒有密鑰、依賴審計沒有高危漏洞、輸入有校驗、鑑權到位、安全響應頭已配置、認證接口有限流、跨域只允許指定來源；
• 性能——核心網頁指標達到「良好」、關鍵路徑沒有 N+1 查詢、圖片已優化；
• 無障礙；
• 基礎設施；
• 文檔。

放量與回滾是這個技能裏最具體的部分。它給了一張判斷表，按指標決定繼續放量、暫停排查還是回滾：

• 錯誤率：與基線相差 10% 以內繼續；高出 10% 到一倍暫停；超過基線兩倍回滾。
• P95 延遲：高出 20% 以內繼續；20% 到 50% 暫停；超過 50% 回滾。
• 前端腳本錯誤：沒有新錯誤類型繼續；新錯誤出現在超過千分之一的會話裏就回滾。
• 業務指標：下降超過 5% 回滾。

另外列出應當立即回滾的情形：用戶反饋激增、發現數據完整性問題、發現安全漏洞。其餘章節講功能開關策略、該監控什麼、錯誤上報、上線後的驗證、用錯誤預算作發佈閘門，以及回滾方案本身。

怎麼安裝

倉庫 README 給出了單獨安裝某個技能的寫法：

bash
npx skills add addyosmani/agent-skills --skill shipping-and-launch

想整套安裝，Claude Code 用 /plugin marketplace add addyosmani/agent-skills 加 /plugin install agent-skills@addy-agent-skills，Codex 用 codex plugin marketplace add addyosmani/agent-skills 加 codex plugin add agent-skills@agent-skills。README 提示，插件安裝遇到 SSH 權限報錯時改用倉庫的 HTTPS 地址。

倉庫整體介紹和其他安裝方式，詳見本站《addyosmani/agent-skills 是什麼、怎麼安裝：Addy Osmani 的 25 個生產級工程 Skills（/spec、/plan、/build）》。

怎麼用

• 「這個版本準備週四上線，按 shipping-and-launch 過一遍檢查清單，告訴我哪些還沒滿足」。
• 「給這次數據庫遷移設計一個分階段放量和回滾方案」。
• 整套安裝後對應 /ship 命令。

讓它逐項給出證據（跑了什麼命令、結果如何），比只打勾可信。

適合誰 / 侷限

適合沒有專職運維和發佈流程的小團隊，拿它當上線前的最後一道自查。侷限：清單偏 Web 應用，移動端、桌面端或數據類項目要自行增減；閾值是經驗值，流量小的產品上統計波動很大，照搬容易誤判；它只能檢查代碼倉庫裏看得到的東西，線上配置和監控是否真的生效需要你去確認。

注意事項

• 許可：MIT。
• 不帶腳本：純說明文字；執行檢查時會運行項目自己的測試、構建和依賴審計命令。
• 是否允許智能體執行實際的部署命令，由團隊的發佈規範決定；這個技能本身只負責準備和核對。