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 技能还包含路由和前导语行为，能帮助 agent 识别何时应该接管这个流程，而不是即兴给出一段宽泛的回答。

如何使用 land-and-deploy 技能

安装上下文和触发短语

先在你的 skill manager 里走 land-and-deploy install 流程，然后在任务明确涉及“完成变更落地并确认生产健康”时调用它。仓库描述和触发词会指向诸如 merge and deploy、land the pr、ship to production、merge and verify 这样的表达。实际使用时，一个高质量的 land-and-deploy usage 提示应该说明哪个分支或 PR 已经准备好、预期部署到哪个环境，以及“完成”具体指什么。

最值得先读的文件

先看 SKILL.md，再查看 SKILL.md.tmpl，了解生成行为的模板源文件。由于这个仓库没有配套的 rules/、references/、resources/ 或 scripts/ 目录，主要实现逻辑都集中在技能文件本身。阅读 land-and-deploy guide 时，优先关注前导语、安全操作约束、plan-mode 行为和路由部分，再看其他内容。

如何提示，效果才更好

给 agent 的发布信息要尽量精简，但必须足以让它安全执行：仓库名、PR 链接或分支、部署目标、所需审批，以及部署后要检查的健康信号。更好的提示会足够具体，例如：“使用 land-and-deploy 合并 PR #184，等待 CI 和生产部署完成，然后确认 staging-to-prod rollout 里的 canary 检查通过。”不要只说“ship it”这种模糊请求，除非仓库上下文已经让目标非常明确。

真正有影响的工作流建议

这个技能的设计重点是接管 PR 创建之后的阶段，所以不要让它去发明变更本身。如果部署路径依赖仓库特定命令、分支命名或必须提供的验证 URL，请提前写明。对于 land-and-deploy for Deployment 来说，质量提升通常来自把验收检查说清楚：是 smoke test、canary、状态页，还是其他生产健康信号。

land-and-deploy 技能常见问题

这只是一个通用的部署提示词吗？

不是。land-and-deploy 是一个聚焦于“合并到生产”阶段的操作型技能，明确支持等待 CI、等待部署、以及验证健康状态。普通提示词也能描述这个顺序，但这个技能的目的，是让 agent 稳定、持续地按这个流程执行。

什么时候不该用它？

如果你需要的是设计决策、代码实现，或者一个还没准备好合并的发布方案，就不要用 land-and-deploy。如果你的组织禁止自动合并或生产操作，或者你只需要一个完全手工执行、没有 agent 动作的检查清单，它也不合适。

它适合新手吗？

适合，只要用户能说明目标仓库、PR 和部署预期。这个技能能减少发布过程中的歧义，但前提仍然是操作者知道哪些内容应该被落地，以及成功如何衡量。新手通常在明确提供 PR，并要求 agent 严格按 land-and-deploy 工作流执行时，效果最好。

应该拿它和什么比较？

可以把 land-and-deploy 和一个普通的“merge and deploy”提示词对比。若你需要可重复的行为、一致的安全操作边界，以及从合并到验证更清晰的路径，它会更合适。如果你只需要一次性的指令，提示词可能就够了；如果这是一个重复出现的发布步骤，那么安装这个技能通常是更好的选择。

如何改进 land-and-deploy 技能

提供更强的发布输入

想让 land-and-deploy 输出更好，最有效的方法就是把具体的 PR、分支、环境和验证方式说清楚。不要只说“deploy this”，而是说“将 PR #57 落到 main，等待 production pipeline 完成，然后确认 /health 返回 200 且 release canary 为绿色。”这样技能就有了明确的终点。

尽早减少失败模式

常见的失败模式包括缺少部署上下文、审批边界不清，以及部署后检查过于薄弱。如果你的流程有受保护分支、强制审查、feature flag 或手动 rollout 步骤，请在技能开始执行前说明。这样可以避免 agent 在策略约束上猜测，或者在合并后过早停止。

首次运行后继续迭代

如果第一次使用 land-and-deploy 时过于保守、范围太宽，或者检查了错误的信号，就不要只重复目标，而是补上缺失的操作细节。加入仓库特定命令、部署看板链接，或你希望验证的具体 canary 标准。这样是让 land-and-deploy 逐步贴近你的真实发布流程、而不是变成一个通用部署脚本的最快方式。