Deploy Pass 是一个面向软件项目的部署系统设计技能。它的核心目标不是执行一条部署命令，而是理解一个具体项目真正需要什么样的部署系统，并据此设计、生成和操作它。
用途
部署不是一条命令，而是一个系统：构建 → 制品 → 打包 → 配置 → 发布 → 运行 → 验证 → 观测。Deploy Pass 的职责是发现项目实际需要什么，设计这套系统，生成相应组件，并且只有在每一步都获得明确许可后才操作它。它不会假设技术栈、云服务商或发布策略，而是通过项目证据来发现它们。例如，部署到 Vercel + Render + NeonDB 的项目与部署到 GCP 上 Kubernetes 集群的项目需要完全不同的系统，Deploy Pass 会根据项目证据决定采用哪种，而不是套用默认值。
主要能力
该技能可以：分析项目；询问无法推断的信息；设计部署工作流；生成工作流、脚本和配置；仅在获得授权后执行命令；验证一切是否正常工作；检测问题；仅在获得授权后执行回滚；记录整个过程。
它明确不会假设：默认基础设施或服务商、密钥或凭据、生产权限、发布策略、任何破坏性操作、任何未经用户批准的决定。用户拥有控制权，该技能是副驾驶，不是操作员。
使用方式
该技能实现的工作流为：DISCOVER → DESIGN → GENERATE → EXECUTE → VERIFY → DOCUMENT，并带有反馈循环：VERIFY 和 DOCUMENT 学到的东西会反馈到同一项目下一次部署的 DESIGN 中。
-
DISCOVER：在提出任何建议之前，先建立项目的真实模型。读取现有内容（优先使用 glob/grep，不假设文件布局），并直接询问无法推断的信息，包括技术栈/运行时/框架/包管理器、构建过程及其输出、测试、数据库及其访问方式、外部服务与集成、现有基础设施、现有 CI/CD、环境变量与密钥处理方式、域名/存储/队列/可观测性、单仓库或 monorepo 及其边界、是否有作为发布包被第三方消费的制品等。使用 assets/deployment-system-vocabulary.md 作为需要留意的清单，而不是机械填写的表格。
-
DESIGN：针对实际适用的每个模块，决定并论证具体方案，包括构建、制品、配置与密钥、基础设施、环境、发布策略、数据与迁移、部署门禁、验证与观测、恢复。设计写入 DEPLOY-PLAN.md，然后停止并等待用户明确批准计划。这是一个硬性检查点，不是形式。批准覆盖整个计划；一旦给出，进入 GENERATE。
-
GENERATE：在 DEPLOY-PLAN.md 中的计划获批后，生成计划要求的具体制品：CI/CD 工作流文件、构建/部署脚本、配置模板、迁移脚手架。生成文件不是不可逆操作，不需要像 EXECUTE 那样逐步授权，但这里生成的内容不会自行运行。
-
EXECUTE：此阶段没有任何操作会在用户对具体动作、具体时刻明确授权之前运行。按照计划步骤（构建 → 打包 → 配置 → 发布 → 运行）推进，在每一步触及真实基础设施、真实密钥或真实环境之前询问。绝不将“直接完成整个部署”批量授权为对破坏性步骤的一次性全面批准。
-
VERIFY：运行计划定义的健康检查、冒烟测试和关键路径检查。在宣布完成之前确认发布确实成功——一个“完成”但健康检查失败的部署是失败的部署，而不是成功部署加一个后续问题。
-
DOCUMENT：将发生的情况追加到 DEPLOY-PLAN.md：执行了什么、验证显示了什么、出了什么问题以及如何解决。这使计划成为活记录——该项目下一次 Deploy Pass 会先读取它，而不是从零重新发现一切。
适用场景
适用于需要为单个软件项目设计完整部署系统的场景，包括构建、制品、配置与密钥、基础设施、环境、发布策略、数据迁移、部署门禁、验证与观测、恢复等环节的设计与生成。它按需调用，一次处理一个项目。
限制
该技能目前不会将自身接入现有 CI/CD 触发器、不会无人值守运行，也不会同时管理多个项目——这些是后续需要构建的真实需求，而不是 v1 中要推测的内容。它可能分析、询问、设计、生成文件并自由提议，但绝不在没有用户对具体动作、具体时刻明确授权的情况下执行不可逆或影响生产的操作——部署、发布、回滚、基础设施变更、密钥轮换、数据迁移。设计回滚计划是该技能的职责；按下回滚按钮始终由用户决定。
输出
项目根目录下的 DEPLOY-PLAN.md——在 DESIGN 之后、任何执行之前写入。在 EXECUTE 和 VERIFY 之后更新执行/验证日志。GENERATE 中生成计划要求的 CI/CD 工作流文件、脚本和配置。未经与该具体变更绑定的明确授权，项目中没有其他文件会改变，也没有基础设施或环境会改变。
质量门禁
返回前会静默检查：DISCOVER 确实先发生；计划中没有默认假设基础设施、服务商、密钥、生产权限或发布策略；DEPLOY-PLAN.md 存在并在任何 EXECUTE 步骤运行前展示给用户；技能确实在 DESIGN 后停止并等待明确计划批准；每个触及真实基础设施、密钥或环境的 EXECUTE 动作都有明确、具体的授权；VERIFY 确实运行并记录结果；DOCUMENT 记录了发生的情况，包括失败。