关于 deploy
Deploy 是一项指导 Agent 将 trunk 上的 Web 应用部署到预览、预发布或生产环境的技能。它要求执行质量门禁、部署后验证，并为失败情况提供回滚路径；生产部署须经明确确认。
主要功能
- 01部署前运行格式、lint、类型检查等门禁
- 02从 trunk 部署到预发布或生产环境
- 03检查健康状态、日志与关键流程
- 04失败时提供回滚步骤
- 05生产部署前要求明确确认
适用场景
- 01将 trunk 变更部署到 staging
- 02验证生产环境部署及关键用户流程
- 03部署失败后恢复并重新部署
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/deploy确认已加载。
附带文件references/workflow.md
详细介绍
部署
从 trunk 将 Web 应用部署到预发布环境或生产环境，并设置关卡、验证流程和回滚路径。
约定
输入：
- 仓库根目录
- 目标环境：预览、预发布或生产
- 可选的分支、PR 编号、部署提供方和健康检查 URL
输出：
- 部署前关卡的检查结果
- 部署路由和提供方
- 验证状态
- 必要时提供回滚或后续操作说明
创建/修改：
- 仅在部署前修复未通过的关卡时修改本地内容
- 仅通过
release技能创建发布 PR 或标签
外部副作用：
- 可能触发提供方的部署
- 可能通过委派的发布技能创建或更新 GitHub PR
- 可能读取日志和监控系统
需要确认：
- 生产环境部署前
- 合并发布 PR 前
- 执行回滚命令前
- 强制推送或重写历史前
委派给：
- 通过读取已安装技能目录中的操作手册并遵循其说明来运行委派技能
（
/<router> <action>：<router>/references/<action>.md；/<name>：<name>/SKILL.md）； 此处的技能只能由用户调用，因此 Skill 工具无法加载它们。 release：检查 trunk SHA 并切出发布版本/git ci：处理未通过的 GitHub Actions 检查
本地质量关卡（必需）
每次部署前，都要运行仓库自己的格式化、lint 和类型检查脚本（并在已配置时运行测试和构建）。从 package.json 中确认实际的脚本名称；切勿猜测或串联使用多个包管理器（使用仓库自己的包管理器，默认使用 Bun）。推送或部署前修复所有失败项。优先使用由 CI 驱动的部署，而不是在本地运行提供方 CLI。
流程
预发布环境
- 确保 trunk 的 CI 检查全部通过。
- 从 trunk 触发预发布部署（不使用预发布分支）。
- 等待 CI 和预发布健康检查通过。
生产环境
- 确保预发布环境运行正常。
- 必须获得明确确认。 生产环境至关重要。
- 从 trunk 部署到生产环境。
- 监控部署；持续观察健康端点和错误跟踪 15 分钟。
热修复
从 trunk（默认分支）切出 hotfix/xxx 分支，完成修复后向 trunk 提交 PR，合并并部署到生产环境。
部署后验证
- 检查健康端点。
- 检查错误跟踪（Sentry 或类似服务）。
- 验证关键用户流程。
- 检查部署日志。
回滚
如果部署失败，撤销合并提交并重新部署。
参考资料
references/workflow.md 包含特定平台的部署详情、AWS 模式、CI/CD 集成和回滚流程。其中的命令示例均为通用占位内容；请替换为仓库自己的包管理器和脚本。
评论
支持 Markdown