Agent Skills
返回列表
🔒

自动化健康巡检·假活自愈

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c57ddd5f/automation-health。

技能介绍

要解决什么问题

后台长进程最容易骗过人眼:进程还在、CPU 也在转,但队列 Pending 不动、embedded_at 不刷新、业务产出趋近于零——这就是 SKILL 里定义的 假活(False-Alive)。文档里举过真实案例:qmd embed worker 占满多核、累计 CPU 时间很高,十几分钟却只写入少量向量,根因往往是内存吃紧导致嵌入会话反复 LLM session expired,而老式看门狗只要看见 PID 还活着就判健康。

本技能只 Own「长进程健康」这一层:不代替 knowledge-base-starter / retrieval-ops 去搭知识库,而是专门对付「后台跑着但其实是死的」。

技能如何工作

判断健康时不能只说「进程在跑」,而要对照 业务指标证据(三选一即应视为异常):

  1. qmd status 的 Pending 长时间不降
  2. content_vectors.embedded_at 最新时间戳停住、不再刷新
  3. 最近 N 分钟新写入向量 ≈ 0,同时 CPU 仍在高占用

在 Windows 上查真进程时,Git Bash 的 ps 对 PID 匹配不可靠,应使用 PowerShell 原生查询;若自查命令自身含 qmd embed 字样,需排除自身 PID,避免自匹配误报。自愈前按流程复查:确认真杀干净、避免误杀无关 node;暂停自动化前确认正确任务 id,避免误停无关作业。报告「进程健康」时必须附上 Pending 趋势、embedded_at、最近写入数等,不能空口下结论。

适用边界与注意点

  • 适用范围:嵌入 worker、队列型后台任务等「有明确业务进度信号」的长进程巡检与假活处置。
  • 不覆盖:知识库搭建、检索运维的一般性 SOP(见其他 skill)。
  • 环境侧重:真进程查询与可靠性经验面向 Windows + PowerShell;在别的平台上需自行对照等价手段。

使用场景

  • qmd embed worker CPU 飙高但 Pending 与 embedded_at 长期不变,需要判定假活并安全重启
  • 看门狗脚本只检查进程是否存在,需要改成对照向量写入量与队列 Pending 的健康标准
  • 在 Windows 上用 PowerShell 精确匹配 qmd 相关 PID,避免 Git Bash ps 漏报或自查命令自匹配
  • 杀僵死嵌入进程或暂停自动化前,需要复查 PID 与任务 id,避免误伤其他 node 或定时任务

适合人员

  • 维护向量知识库嵌入流水线的 SRE,要区分配额耗尽与会话过期导致的假活空转
  • 在 Windows 服务器上跑 QMD 相关任务的运维,需要替代「进程在就算健康」的 ps1 看门狗
  • 负责后台队列消费的开发,希望用 Pending / embedded_at 写进值班 runbook 的诚实健康报告
  • 编写自动化杀进程脚本的工程师,要避免误杀无关 node 或停错调度任务 id