概述
ssh-dev-suite/debug 是一个结构化远程服务器问题排查流程技能，用于引导智能体按步骤排查远程服务器问题，避免盲目执行命令。所有远程命令通过 connect/scripts/ssh-exec.sh 执行。
适用场景
- 服务异常，如进程崩溃、服务不可用
- 性能问题，涉及 CPU、内存、磁盘或 GPU
- 部署失败排查
- 容器内应用调试
流程步骤
- 确认目标：获取问题描述，确认 profile 和排查方向。产出为 profile 名称加问题分类。
- 上下文感知环境检查：读取本地工程文件推断依赖，动态生成检查项。基础检查包括 uptime、df -h、free -m、top -bn1 | head -20，并按规则表执行额外检查。产出为环境状态概览。
- 日志分析：定位日志，如 journalctl -u <service> --since "1h ago"、/var/log/；搜索关键词，如 grep -i "error|fatal|exception" <log> | tail -50；容器场景使用 docker logs <container> --tail 200。产出为错误信息摘要。
- 深入排查：根据线索执行针对性命令，每次验证一个假设；检查配置文件、环境变量、依赖版本。产出为根因或最可能原因。
- 总结报告：输出发现（现象、根因、影响）和修复建议，产出结构化排查报告。
上下文感知规则表
- 检测到 PyTorch / TensorFlow：执行 nvidia-smi，检查 GPU 显存占用
- 检测到华为 CANN / MindSpore：执行 npu-smi info，检查 NPU 状态
- 检测到 Docker / docker-compose：执行 docker ps -a、docker stats --no-stream
- 检测到数据库连接配置：进行连通性测试、检查活跃连接数
常用排查命令速查
- 进程：ps aux | grep <app>、systemctl status <svc>
- 资源：df -h、free -m、top -bn1 | head -20
- 日志：tail -100 <log>、journalctl -u <svc> --since "1h ago"
- 网络：ss -tlnp、curl -sv localhost:<port>
- 容器：docker logs <c> --tail 100、docker stats --no-stream
- GPU：nvidia-smi、npu-smi info
容器内调试
当 profile 配置 container 字段时，ssh-exec.sh 会自动将命令路由到容器内。需要注意：容器内工具可能缺失，优先使用基础命令（cat、ls、env）；需要宿主机信息时，使用不带 container 的 profile。
Token 约束
- 日志分析：先用 grep 搜索错误关键词，再按需扩展上下文
- 大日志文件：只读 tail -50，不读全文
- 环境检查：输出摘要，不粘贴完整命令结果
- 深入排查：每次验证一个假设，不批量执行命令
- 重复信息：不复述已知内容
限制
资料未提供该技能的具体安装方式、依赖版本要求、支持的 profile 配置格式细节、收费信息及对应平台范围，暂未提供。