复现已有算法

.agents/skills/edge-observability/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: edge-observability
+description: edge_collector 运行观测与资源诊断规范。用于排查边缘主机或云服务器 CPU 高、内存占用、磁盘空间、/tmp 清理、进程数量、jq/python/agent 异常、服务日志、端口监听和系统负载时，按只读证据链输出分析结论。
+---
+
+# edge_collector 运行观测
+
+## 适用场景
+
+- CPU 占用高。
+- 内存比其他主机高。
+- `/tmp` 或工程目录占用大。
+- `jq`、Python、agent 进程很多。
+- 服务频繁重启。
+- 网关在线状态异常。
+- 前端或云端接口偶发失败。
+
+## 排查顺序
+
+1. 系统概况。
+2. CPU 和进程。
+3. 内存。
+4. 磁盘。
+5. systemd 服务。
+6. 应用日志。
+7. 网络端口。
+8. 与对照主机比较。
+
+## 常用命令
+
+系统：
+
+```bash
+uptime
+free -h
+df -h
+uname -a
+date
+```
+
+CPU/进程：
+
+```bash
+ps -eo pid,ppid,user,stat,pcpu,pmem,rss,etime,cmd --sort=-pcpu | head -30
+ps -eo pid,ppid,user,stat,pcpu,pmem,rss,etime,cmd --sort=-rss | head -30
+```
+
+进程树：
+
+```bash
+pstree -ap
+```
+
+磁盘：
+
+```bash
+du -h --max-depth=1 /home/cat 2>/dev/null | sort -h
+du -h --max-depth=1 /tmp 2>/dev/null | sort -h
+```
+
+服务：
+
+```bash
+systemctl status edge --no-pager
+journalctl -u edge --since "30 min ago" --no-pager
+systemctl list-units --type=service --state=running
+```
+
+端口：
+
+```bash
+ss -lntp
+```
+
+## 分析规则
+
+- 短时尖峰和持续高占用分开判断。
+- 先找父进程，再判断是脚本循环、服务重启还是用户命令。
+- 内存分析区分 RSS、缓存和可用内存。
+- 磁盘清理只给建议，删除必须等用户确认。
+- 与 119.45.4.75 或其他主机对比时，列出相同指标。
+
+## 高风险操作
+
+以下操作必须用户明确同意：
+
+- 删除文件或目录。
+- kill 进程。
+- 重启服务。
+- 清理日志。
+- apt 安装诊断工具。
+
+## 报告格式
+
+```text
+结论：
+
+证据：
+- CPU:
+- 内存:
+- 磁盘:
+- 进程:
+- 日志:
+
+判断：
+
+建议：
+```
+
+## 当前项目常见根因
+
+- shell + `jq` 高频轮询导致短时 CPU 尖峰。
+- 未插 SIM/设备缺失导致 4G 脚本重复探测。
+- 前端构建产物或代码仓库占用较大。
+- `/tmp` 离线安装包、构建缓存未清理。
+- 独立 agent 异常退出后被 systemd 频繁拉起。