SuperAPI AI 工具集

process-manager

部署与运维

查看项目

更新于 10-15 23:43

技能介绍

用途:管理开发服务器与长运行进程,适合启动、停止、查看 Node.js 开发服务器状态,运行测试前确保服务可用,以及排查端口冲突。核心原则是「端口即真相」,不信任 PID 文件或记忆,始终检查端口实际监听情况;启动时脱离终端后台运行,通过端口验证,绝不等待开发服务器退出。

主要能力:检查全部进程、单个进程或进程组状态;启动、重启、停止单个进程或进程组;查看配置端口与常见开发端口(3000、4000、5173、8080 等)占用;支持健康检查,状态分为 RUNNING、RUNNING [healthy]、RUNNING [unhealthy]、STOPPED;可输出 JSON;被请求的进程处于停止状态时退出码为 1。

使用方式:配置位于项目根目录 .claude/process-config.json,包含进程、组与默认值;脚本位于 .claude/skills/process-manager/scripts/process-manager.ts。常用命令包括:deno run --allow-run --allow-read --allow-net scripts/process-manager.ts status --all、start authoring-api、start authoring、stop all、status authoring-api、ports;查看配置用 deno run --allow-read scripts/process-manager.ts list。权限按命令区分:list 用 --allow-read;status、start、restart 用 --allow-run --allow-read --allow-net;stop、ports 用 --allow-run --allow-read。

限制与注意事项:不等待开发服务器退出;不凭 PID 文件判断运行状态;启动前必须检查端口,冲突时由用户决定是否终止;不杀进程而不告知用户;不执行配置列表外的命令;未验证端口前不假定启动成功。该技能不产生持久输出,进程状态由端口检查决定。