SuperAPI AI 工具集

agentic-process-monitor

部署与运维

查看项目

更新于 10-16 01:13

技能介绍

用途:为 Claude Code 中的后台任务提供可靠的进程监控方案,解决 run_in_background 单独使用容易卡死、任务 ID 失效、无法获取中间进度的问题。

主要能力:采用哨兵文件 + 心跳 + 子智能体三层架构。工作进程在已知目录(如 /tmp/monitor/)写入四类文件:<step>.pid(PID,用于超时终止)、<step>.heartbeat(每 N 秒更新 mtime 作为存活证明)、<step>.status(退出时写 SUCCESS/FAILED)、<step>.result(成功时写结构化 JSON)。子智能体按下述决策树轮询:.status 存在则返回结果;.heartbeat 的 mtime 过期判定进程卡死并 kill PID;超过 MAX_TIMEOUT 判定超时并 kill PID;否则继续轮询。推荐默认值 POLL_INTERVAL 15s、HEARTBEAT_INTERVAL 10s、STALE_THRESHOLD 60s、MAX_TIMEOUT 1800s。另含熔断机制:连续 3 次失败即停止并报告,成功则重置计数;以及智能体自愈:若监控子智能体死亡,主上下文可直接检查哨兵文件恢复。

使用方式:用 Bash 包装脚本启动工作进程并写入哨兵文件,再启动子智能体轮询。进入自主循环前需运行环境预检:uv run --python 3.14 python -c "import your_package" 或 uv sync --python 3.14 --extra dev;检查控制台脚本 shebang;用 curl 检查外部服务可达性。仓库重命名、目录移动或 Python 版本变更后,一律先执行 uv sync --python 3.14 --extra dev。

适用场景:远程/排队任务编排、并发作业安全管理等需要长时等待又不想占用主上下文 token 的场景;配套技能为 pueue-job-orchestration 与 distributed-job-safety。

限制:文档未提供具体安装命令、价格或平台支持信息;示例中的 your_command 与端口需自行替换;参数依实际环境调整。该技能自述会通过使用持续自我修正,仅在问题可复现时更新。