land-and-deploy

land-and-deploy 技能概覽

land-and-deploy 的用途

land-and-deploy 是一個工作流程技能，用來處理「PR 已合併」到「已驗證的正式環境部署」這段交接流程。它是為發佈流程中的 land-and-deploy 步驟而設計的：先合併變更，等待 CI 與部署完成，再透過 canary 檢查確認應用正常。如果你需要一個能降低最後上線步驟猜測成本的 land-and-deploy 技能，這正是它的目標。

適合安裝的人

如果你平常會叫 agent 去做「merge it」、「land the PR」、「ship to production」或「merge and verify」，就很適合安裝 land-and-deploy。它最適合已經有 /ship 或 PR 建立步驟的團隊，並想要在部署與驗證階段補上一個接續技能。若你的團隊根本不允許 agent 執行合併、部署或正式環境驗證，那它就不太有用。

這個技能有什麼不同

它的核心價值不是一般性的發佈建議，而是一套有明確限制的部署流程，特別強調安全操作、等待 CI/部署完成，以及部署後驗證。land-and-deploy 技能也包含 routing 和 preamble 行為，能幫助 agent 判斷何時應該由這個工作流程接手，而不是自行發揮、亂給一個大範圍答案。

如何使用 land-and-deploy 技能

安裝情境與觸發語句

先在你的技能管理器裡走 land-and-deploy install 流程，然後在任務明確是要落地變更並確認正式環境健康狀態時再呼叫它。repository 說明與觸發語句指出的典型表達包括 merge and deploy、land the pr、ship to production 和 merge and verify。實務上，一個好的 land-and-deploy usage 提示應該清楚說明哪個 branch 或 PR 已經準備好、預期的環境是什麼，以及「完成」的定義。

最先該讀的檔案

先讀 SKILL.md，再查看 SKILL.md.tmpl，了解產生這個行為的樣板來源。因為這個 repo 沒有 rules/、references/、resources/ 或 scripts/ 資料夾，所以主要實作都寫在 skill 檔本身。閱讀 land-and-deploy guide 時，請先聚焦在 preamble、安全操作限制、plan-mode 行為，以及 routing 區段，而不是先看別的內容。

如何下提示，讓執行更穩

提供 agent 最少但足夠的發佈資訊，讓它能安全行動：repo 名稱、PR 連結或 branch、部署目標、任何必要核准，以及部署後要檢查的健康訊號。更好的提示會寫得更具體，例如：「使用 land-and-deploy 合併 PR #184，等待 CI 與 production deployment 完成，然後確認 staging-to-prod rollout 的 canary checks 通過。」除非 repo 脈絡已經很明確，否則像「直接 ship」這種模糊要求不建議使用。

影響成敗的工作流程提示

這個技能的設計重點是接手 PR 建立之後的流程，所以不要叫它去發明變更本身。如果部署路徑依賴 repo 專屬命令、branch 命名規則，或必須驗證的 URL，務必先提供。對 land-and-deploy for Deployment 來說，品質提升通常來自於把驗收檢查說清楚：smoke test、canary、status page，或其他正式環境健康訊號。

land-and-deploy 技能 FAQ

這只是一般的部署提示嗎？

不是。land-and-deploy 是一個聚焦在 merge-to-production 階段的操作型技能，明確支援等待 CI、等待部署，以及驗證健康狀態。一般提示也能描述這個流程，但這個技能的目的，是讓 agent 能穩定、一致地照做。

什麼情況不該用？

如果你需要的是設計決策、程式實作，或尚未準備好合併的發佈計畫，就不適合用 land-and-deploy。如果你的組織禁止自動合併或正式環境操作，或者你需要完全人工執行、沒有 agent 介入的檢查清單，它也不是好選擇。

新手也適合嗎？

適合，只要使用者能說清楚目標 repo、PR，以及部署預期。這個技能可以減少上線時的模糊地帶，但前提仍是操作人知道要落地的是什麼，以及成功要怎麼衡量。新手通常在提供 PR，並要求 agent 完整照 land-and-deploy 工作流程執行時，效果最好。

應該拿它跟什麼比較？

可以把 land-and-deploy 跟單純的「merge and deploy」提示相比。當你需要可重複的行為、一致的安全邊界，以及從合併到驗證更清楚的路徑時，這個技能表現會更好。如果你只需要一次性的指示，提示詞可能就夠了；但如果這是反覆發生的發佈步驟，安裝這個技能通常更值得。

如何改進 land-and-deploy 技能

提供更完整的發佈輸入

要提升 land-and-deploy 的輸出品質，最有效的方法就是指定精確的 PR、branch、環境與驗證方式。不要只說「部署這個」，而是說「把 PR #57 落地到 main，等待 production pipeline 跑完，再確認 /health 回傳 200，且 release canary 為綠燈。」這樣能給技能一個明確的完成條件。

盡早降低失敗風險

常見失敗原因包括缺少部署情境、核准邊界不清楚，以及部署後檢查太弱。如果你的流程有受保護的 branches、必須審查、feature flags，或手動 rollout 步驟，請在技能動作前先說明。這可以避免 agent 在政策限制上猜測，或在合併後太早停下來。

第一次執行後再迭代

如果第一次 land-and-deploy 的執行過於保守、範圍太大，或檢查了錯誤的訊號，就不要只是重述目標，而是補上缺少的操作細節。加入 repo 專屬命令、部署儀表板連結，或你要驗證的精確 canary 條件。這是讓 land-and-deploy 更像你真實發佈流程，而不是一般部署腳本的最快方法。