用途:为 POSIX shell、macOS 和 Linux 上的长任务提供终端操作手册,管理 tmux 后台会话、日志抓取、停滞诊断与安全恢复。不宣称支持 Windows 原生环境,Windows 用户需在 WSL 等 POSIX 环境中使用。仅查看短命令输出或文件内容时无需调用。
主要能力:启动或观察长任务(用参数化 session、日志目录和命令启动 tmux/后台任务);判断任务是否停滞(在指定观察窗口内交叉检查日志、CPU、网络/子进程进展,给出运行中、疑似停滞或无法判断结论);恢复或终止任务(先确认目标与数据风险,按 TERM→复查→KILL 顺序处理)。命令风险分级:tmux list-sessions、ps、tail、lsof 等为默认只读/幂等;kill、tmux kill-session 及 fallback 命令属高影响动作,须先说明依据与风险并获得确认,禁止用 pkill/killall 替代精确 PID。
使用方式:安装命令 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-terminal-ops -y。强依赖 POSIX shell、ps、kill;tmux 工作流派依赖 tmux;网络检查可选 lsof。需提供命令、工作目录、PID 或 tmux session、session_name、log_dir、stall_window_seconds、term_grace_seconds 等参数,缺失且影响终止目标或日志落点的输入应先询问。可选配置路径 ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-terminal-ops/config.yml,或用 SOIA_DEV_TERMINAL_OPS_CONFIG_FILE 指定。
适用场景:监控预计超过 30 秒的命令;管理 tmux 会话、后台 build/test 或持续日志;诊断进程无输出、工具挂起或终端不可恢复;在确认门下终止或降级长任务。
限制:长时间处于 S 状态可能属正常等待,单一时长或超时不是终止条件;仅当观察窗口超过阈值且至少两个独立进展信号持续无变化、无合理解释时,才标为 suspected-stall;信号不足标为 inconclusive。lsof 缺失时网络信号标为未检查,不能据此判死锁。具体收费、价格及平台兼容细节暂未提供。