Communitygithub.com

metyatech/skill-post-deploy

代理技能,用於在全局連結套件、執行中服務和守護進程的程式碼變更後驗證部署。

skill-post-deploy 是什麼?

這個技能旨在讓 AI 代理在修改程式碼後,自動化地驗證部署的正確性。它特別適用於那些使用 `npm link` 進行全局連結的套件、透過 PM2 或 systemd 管理的執行中服務,以及由 cron 或 Windows 工作排程器設定的排程任務。代理會先檢測受影響的元件(如全局連結的套件或相關服務),然後執行重建和驗證步驟。對於連結套件,它會執行構建命令並檢查 CLI 版本;對於服務,它會重建、重啟服務管理器,並透過檢查新的 PID、監聽埠、服務狀態或日誌條目來提供確定性證據。最終,代理必須出示這些驗證證據才能宣告完成,確保執行中的實例確實反映了最新的程式碼變更。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

變更後部署程序

檢測

全域連結套件

  • 代理程式必須執行 npm ls -g --depth=0 並尋找包含 -> 指向本機路徑的條目。
  • 如果修改的儲存庫與全域連結的套件相符,代理程式必須繼續進行重建。

執行中服務與排程任務

  • 代理程式必須檢查與儲存庫相關的執行中程序(服務名稱、PM2/systemd/Windows 服務條目)。
  • 代理程式必須檢查參照該儲存庫的排程任務(cron、Windows 工作排程器)。

重建與驗證

npm 連結套件

  1. 執行儲存庫的建置命令(例如 npm run build、 tsc)。
  2. 透過執行 CLI 的 --version 或冒煙測試命令來驗證重建後的輸出。
  3. 回報已驗證的版本。

服務與守護程式

  1. 重建服務元件。
  2. 使用服務管理器重新啟動(PM2 restart、systemctl restart 等)。
  3. 使用確定性證據進行驗證:
    • 新的 PID(比較前後差異)。
    • 連接埠檢查(驗證正在監聽)。
    • 服務狀態查詢。
    • 顯示更新行為或版本的日誌條目。
  4. 回報驗證證據。

完成閘門

  • 代理程式不得在執行中的實例反映變更之前宣稱完成。代理程式必須在最終回應中包含驗證證據。

相關技能