SuperAPI AI 工具集

soia-dev-terminal-ops

部署与运维

查看项目

更新于 10-16 08:35

技能介绍

用途:管理 POSIX shell、macOS 与 Linux 上的长任务,包括 tmux 后台会话、日志抓取、停滞诊断与安全恢复。不声明 Windows 原生兼容,Windows 需在 WSL 或其他 POSIX 环境使用。

主要能力:以指定 session 名、日志目录和命令启动 tmux/后台任务;在观察窗口内交叉检查日志进展、累计 CPU time、网络/IPC 连接、子进程与任务特定心跳,给出 running、suspected-stall、inconclusive 等结论;终止时先核对 PID、父 PID、完整命令与工作目录,再按 TERM→复查→KILL 门执行,必要时运行 fallback 命令。

使用方式:需提供命令与工作目录、已有 PID 或 tmux session,以及 session_name、log_dir、stall_window_seconds、term_grace_seconds 等参数;缺少会改变终止目标或日志落点的输入时先询问。只读操作如 tmux list-sessions、ps -o pid,ppid,stat,etime,time,command -p <PID>、tail、lsof 可直接执行;kill -TERM、kill -KILL、tmux kill-session、执行 fallback 等高影响动作需先说明目标、依据与数据风险并取得确认。

安装命令: claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-dev@soia 仅装本技能: npx skills add soia-team/soia-open-dev-skills -g -a '*' -s soia-dev-terminal-ops -y

依赖与配置:强依赖 POSIX shell、ps、kill,tmux 工作流要求 tmux;lsof 可选,缺失时标为“网络信号未检查”。配置文件为 ~/.config/soia-skills/soia-dev-terminal-ops/config.yml 或由 SOIA_DEV_TERMINAL_OPS_CONFIG_FILE 指定;未给日志目录时先使用 ${TMPDIR},TMPDIR 也未设置则请用户指定。含秘密的命令不得写入配置或日志。

限制与注意:长时间处于 S 状态或单一超时不是 kill 条件,只有观察窗口超过阈值且至少两个独立进展信号持续无变化时才判疑似停滞,信号不足标 inconclusive;禁用宽泛 pkill/killall。按 A–E 五类管理输出:临时日志默认任务结束后清理,审计记录在保留策略确认前不删除,交付物只写用户指定路径,纯 stdout 不落盘。需持久审计时写入客户指定 state 根目录或 ${XDG_STATE_HOME:-~/.local/state}/soia-skills/soia-dev-terminal-ops/。