用途
ai-factory.deploy 是一个部署助手技能,用于帮助用户安全地准备和执行部署,通过自动化检查和文档生成来降低部署风险。它强调“绝不自动部署”,所有部署动作都需要用户确认或手动执行。
主要能力
预检检查(无参数时)
不携带参数时,仅运行部署就绪检查,涵盖以下方面:
- Git 状态检查:确保工作目录干净、验证在正确分支、检查分支是否与远程同步。
- 构建检查:运行构建命令(如 npm run build、cargo build 等),报告构建错误。
- 测试检查:运行测试套件,报告覆盖率(如可用)。
- 环境检查:验证必需的环境变量,对比 .env.example 与实际环境。
- 依赖检查:查找安全漏洞(如 npm audit),检查过时的关键包。
预检输出以清单形式呈现,包含各项检查的通过或警告状态,最后给出总体判断(如“Ready for deployment”)。
带环境参数的部署准备
/ai-factory.deploy staging:运行预检检查、生成自上次 staging 部署以来的变更日志、提供 staging 环境的部署命令、将发布标记为 staging-{date}。/ai-factory.deploy production:运行所有预检检查(更严格),要求 Git 状态干净、要求所有测试通过、生成完整发布说明、创建 Git 发布标签、提供生产环境部署命令。
发布说明生成
在部署时,从以下来源生成发布说明:自上次标签/发布以来的 Git 提交、合并的 PR 标题和描述、约定式提交信息。格式按类别分组,如 Features、Bug Fixes、Other Changes,并附上对应的提交信息和 PR 编号。
CI/CD 集成
检测并提供以下平台的部署命令:
- Vercel:vercel --prod
- Netlify:netlify deploy --prod
- Railway:railway up
- Docker:构建和推送命令
- Kubernetes:kubectl apply 命令
- GitHub Actions:触发工作流
使用方式
通过斜杠命令调用:
/ai-factory.deploy:运行所有预检检查,报告就绪状态。/ai-factory.deploy staging:准备 staging 部署并附带变更日志。/ai-factory.deploy production:完整的生产部署工作流并生成发布说明。
适用场景
适用于需要在部署前进行系统化检查、生成发布文档、或需要针对不同环境(staging、production)准备部署命令的开发与运维流程。特别适合希望避免手动遗漏检查项、需要规范化发布说明、或需要明确 CI/CD 部署命令的场景。
安全特性与限制
安全特性包括:
- 绝不自动部署到生产环境。
- 始终显示将要部署的差异。
- 对破坏性操作要求确认。
- 建议回滚命令。
- 记录部署操作。
限制:该技能不自行执行部署(尤其是生产环境),仅提供准备、检查和命令建议。具体部署仍需用户手动执行或通过对应 CI/CD 平台完成。