soia-dev-terminal-opslisted

# soia-dev-terminal-ops 面向 POSIX shell、macOS 和 Linux 的长任务终端操作手册。它不虚标 Windows 原生兼容；Windows 用户应在 WSL 或其他 POSIX 环境中使用。 ## 客户可读说明 ### 这个技能可以做什么 | 客户想要 | 技能会做 | 客户能看到 | |---|---|---| | 启动或观察长任务 | 用参数化的 session、日志目录和命令启动 tmux/后台任务 | command、workdir、session/PID、日志路径和当前状态 | | 判断任务是否停滞 | 在用户指定观察窗口内交叉检查日志、CPU、网络/子进程进展 | 每项信号的证据以及“运行中/疑似停滞/无法判断”结论 | | 恢复或终止任务 | 先确认目标与数据风险，再按 TERM→复查→KILL 顺序处理 | 每个信号、确认点、退出状态和后续恢复建议 | ### 客户如何使用 提供以下输入；缺少会改变终止目标或日志落点的输入时，先询问，不猜： - 要运行或诊断的命令、工作目录； - 已有 PID 或 tmux session（如适用）； - `session_name`、`log_dir`、`stall_window_seconds`、`term_grace_seconds`； - 可选的 `fallback_command`，以及是否预先授权终止目标进程。 只查看短命令输出或文件内容时无需调用本技能。 ### 依赖与安装 安装本技能： ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-terminal-ops -y ``` 强依赖：POSIX shell、`ps`、`kill`。tmux 工作流要求 `tmux`。网络连接检查可选使用 `lsof`；缺少时标为“网络信号未检查”，不能据此判死锁。 可选配置： ```text ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-terminal-ops/config.yml SOIA_DEV_TERMINAL_OPS_CONFIG_FILE=<custom-config-path> ``` 建议配置结构： ```yaml schema_version: 1 env: TERMINAL_OPS_LOG_DIR: "<user-log-dir>" TERMINAL_OPS_SESSION_NAME: "<session-name>" TERMINAL_OPS_STALL_WINDOW_SECONDS: "<seconds>" TERMINAL_OPS_TERM_GRACE_SECONDS: "<seconds>" TERMINAL_OPS_FALLBACK_COMMAND: "<optional-command>" ``` 优先级：本次用户输入/CLI 参数 → 进程环境 → 配置文件。未给日志目录时才使用 `${TMPDIR}`；若 `TMPDIR` 也未设置，先请用户指定目录。 ### 日志与完成回执 每次报告： ```markdown 完成：<启动、诊断、恢复或终止结果>。 日志摘要： - command/workdir: <命令与目录> - session/pid: <会话名或 PID> - log: <日志路径或“纯 std