Communitygithub.com

部署后验证技能

用于在全局链接包、运行服务和守护进程的代码更改后验证部署的Agent技能。

部署后验证技能 是什么?

该技能为AI Agent(如Claude Code、Cursor)提供了一套标准化流程,用于在代码更改后全面验证部署结果。它首先通过检测全局链接包(使用`npm ls -g --depth=0`检查`->`指向本地路径的条目)以及运行的服务和定时任务(检查PM2、systemd、Windows服务、cron等)来识别需要验证的组件。然后引导Agent执行具体的重建和验证步骤:对于npm链接包,运行构建命令(如`npm run build`)并验证CLI版本或执行冒烟测试;对于服务和守护进程,重建组件、通过服务管理器重启,并通过新PID、端口监听、服务状态查询和日志条目等确定性证据进行验证。最后,该技能强制要求Agent在最终响应中包含验证证据,确保运行实例确实反映了更改。此技能支持所有主流平台和环境,特别适合需要确保代码变更后系统状态一致性的开发者。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add metyatech/skill-post-deploy

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

更改后的部署流程

检测

全局链接包

  • Agent必须运行 npm ls -g --depth=0 并查找 包含 -> 指向本地路径的条目。
  • 如果更改的仓库与全局链接包匹配,则 Agent必须继续重建。

运行中的服务和定时任务

  • Agent必须检查与仓库关联的正在运行的进程 (服务名称、PM2/systemd/Windows服务条目)。
  • Agent必须检查引用该仓库的定时任务(cron、Windows 任务计划程序)。

重建与验证

npm 链接包

  1. 运行仓库的构建命令(例如 npm run build、 tsc)。
  2. 通过运行CLI的 --version 或冒烟命令 来验证重建输出。
  3. 报告已验证的版本。

服务和守护进程

  1. 重建服务组件。
  2. 使用服务管理器重启(PM2 restart、systemctl restart等)。
  3. 使用确定性证据进行验证:
    • 新PID(比较前后值)。
    • 端口检查(验证监听状态)。
    • 服务状态查询。
    • 显示更新行为或版本的日志条目。
  4. 报告验证证据。

完成条件

  • Agent不得声称完成,直到运行中的实例 反映了更改。Agent必须在最终响应中 包含验证证据。

相关技能