菜单
对 PostgreSQL 数据库所在服务器进行物理资源风险评估，涵盖磁盘剩余空间、OOM 风险（服务器整体及 PG 进程级内存分析并关联数据库内部视图）、IO 设备使用率及等待、网络带宽使用率四大维度。触发场景包括：磁盘要满了、磁盘空间不足、OOM、内存不够、内存泄漏、进程吃内存、IO 打满、IO 等待高、iostat 告警、网络带宽跑满、服务器资源评估、主机巡检、物理资源体检、容量风险排查等。即使用户只说'帮我看看数据库服务器还撑得住吗'或'这台机器是不是快扛不住了'，也应触发本技能。支持本地直接执行或通过 SSH 远程执行，自动判断执行环境。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/digoal/skills --skill pg-host-resource-risk命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | pg-host-resource-risk |
| description | 对 PostgreSQL 数据库所在服务器进行物理资源风险评估，涵盖磁盘剩余空间、OOM 风险（服务器整体及 PG 进程级内存分析并关联数据库内部视图）、IO 设备使用率及等待、网络带宽使用率四大维度。触发场景包括：磁盘要满了、磁盘空间不足、OOM、内存不够、内存泄漏、进程吃内存、IO 打满、IO 等待高、iostat 告警、网络带宽跑满、服务器资源评估、主机巡检、物理资源体检、容量风险排查等。即使用户只说'帮我看看数据库服务器还撑得住吗'或'这台机器是不是快扛不住了'，也应触发本技能。支持本地直接执行或通过 SSH 远程执行，自动判断执行环境。 |
| tags | ["PostgreSQL","运行时服务器潜在风险分析","剩余空间预警","OOM预警","内存预警","IOPS预警","IO等待预警","IO带宽预警","网络带宽预警"] |
| platform | ["claude-code","cursor"] |
| author | digoal |
| version | 1.0.0 |
| license | GNU General Public License v2.0 |
| homepage | https://github.com/digoal/skills |
对 PostgreSQL 所在服务器做一次只读体检：磁盘、内存(OOM)、IO、网络四个维度，每个维度都要把 OS 层现象关联回数据库内部视图，定位到具体目录/进程/SQL/复制槽/应用，最终产出一份分级的中文风险报告。
PGPASSWORD 提供密码，禁止在命令行明文传递密码。其余连接参数（PGHOST/PGPORT/PGUSER/PGDATABASE）按需设置。df, free, ps, cat /proc/meminfo 为必需，均为系统自带。iostat/sar（sysstat 包）、iftop/nload 为可选增强，缺失时跳过对应分析并在报告中注明局限性。ssh 调用只读命令，不落地密码到磁盘、不写 shell 历史。SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY;，严禁 INSERT/UPDATE/DELETE/DDL。执行 references/sql_queries.sql 中「Step0 基础信息」段：实例版本、启动时间、data_directory、内存相关参数（max_connections/shared_buffers/work_mem/maintenance_work_mem/effective_cache_size）、inet_server_addr()、当前活跃会话列表、pg_tablespace 中的自定义表空间路径。
运行 scripts/env_detect.sh：
hostname -I 与 whoami，比对本地 IP 与 Step 0 中 inet_server_addr() 是否匹配；postgres 主进程（ps aux | grep '[p]ostgres'）。若两个条件均满足 → 判定为「本地模式」，后续所有 OS 命令直接本地执行。 否则 → 判定为「远程模式」，向用户输出：
检测到当前执行环境不是数据库服务器。请提供服务器的 SSH 连接信息（主机、端口、用户名、密码或密钥路径），以便进行物理资源扫描。
收到 SSH 信息后，后续所有 scripts/*.sh 均通过 ssh <user>@<host> -p <port> 'bash -s' < script.sh 的方式在远端执行，密码类连接信息只在当次会话内存中使用，不写入文件。
运行 scripts/disk_check.sh（传入 $PGDATA、WAL 目录、日志目录、/tmp、表空间路径列表、/）：
df -h 全量挂载点及关注目录的剩余空间/使用率。du -ah <dir> --max-depth=3 | sort -rh | head -20 定位大文件。分级标准（对每个关注目录独立判定）：
对告警目录做溯源：
pg_database/pg_class（见 references/sql_queries.sql Step2 段），定位到具体库或表。pg_replication_slots 找未消费的复制槽，或检查归档命令是否失败（pg_stat_archiver）。/tmp 过大：结合 pg_stat_activity 检查是否有长时间运行的排序/临时文件查询。增长预测：结合 pg_stat_user_tables.n_tup_ins 增量与当前数据文件大小做粗略线性外推，估算磁盘写满剩余天数（在报告中注明这是粗略估算，非精确预测）。
运行 scripts/memory_check.sh：
free -hcat /proc/meminfo | grep -E "MemTotal|MemAvailable|SwapTotal|SwapFree|Cached|Buffers"ps aux --sort=-%mem | grep postgres | head -30整体内存分级：
对 RSS > 500MB 或 %MEM > 10% 的 PG 进程，用其 PID 执行 references/sql_queries.sql Step3 段的 pg_stat_activity 关联查询，并按进程类型分支：
pg_stat_statements 可用，按 queryid 关联历史资源消耗，判断是否涉及大排序/大哈希（可能占满 work_mem），或长事务持锁导致内存堆积。pg_stat_progress_vacuum 找正在处理的表，核对 maintenance_work_mem 是否设置过高。pg_stat_replication 的复制延迟，判断是否因 WAL 积压导致内存升高。application_name 分布，判断是否某个应用连接数异常。综合评估：列出内存消耗构成表 —— shared_buffers（固定）+ 连接基础开销（约 5-10MB/连接 × max_connections）+ 活跃查询 work_mem 理论上限 + 并发 autovacuum 的 maintenance_work_mem 上限，与物理内存对比，判断是否存在理论超卖。给出 work_mem/max_connections/shared_buffers 调整建议，或引入连接池（pgbouncer）的建议。
运行 scripts/io_check.sh（若 iostat/sar 不存在则报告工具缺失并跳过本项细节）：
iostat -x 1 3 或 sar -d 1 3，采集 %util, await, r/s, w/s, rkB/s, wkB/s, avgqu-sz。分级：
cat /sys/block/<dev>/queue/rotational）数据库内部关联（见 references/sql_queries.sql Step4 段）：
pg_stat_bgwriter 中 buffers_backend 与 buffers_checkpoint 比例，判断 IO 主要来自后端查询还是检查点。pg_stat_statements 按 shared_blks_read 降序 TOP 10，找出磁盘读最多的 SQL，并计算缓存命中率。pg_statio_user_tables/pg_statio_user_indexes 找 heap_blks_read 最高的表/索引。checkpoints_req 远大于 checkpoints_timed，提示 max_wal_size 可能偏小，建议增大。输出 IO 消耗来源归总表（检查点/后端直读/VACUUM/WAL 写），各给根因和优化建议。
运行 scripts/network_check.sh：
sar -n DEV 1 3；否则读取两次 /proc/net/dev 采样计算速率；ethtool <iface> 或 /sys/class/net/<iface>/speed 获取网卡额定带宽。iftop -t -s 3 或 nload -t 3 做交叉验证。分级（按 rx+tx 占额定带宽比例）：
数据库内部关联（见 references/sql_queries.sql Step5 段）：
pg_stat_replication 的 write_lag/flush_lag，及两次采样 pg_current_wal_lsn() 算出的 WAL 生成速率，估算复制占用带宽。pg_stat_activity 中 state='active' 且疑似返回大量行的会话，或 pg_stat_statements 中 rows 极大的查询。ss -tup 排查是否有非 PG 端口的大流量，提示混合部署风险。按 references/report_template.md 的结构输出最终中文报告，要点：
shared_buffers/work_mem/max_connections/max_wal_size 等）。rm/kill/reboot/参数热改；SQL 严禁写操作。PGPASSWORD 环境变量或当次会话内存中的 SSH 凭据，不写入任何文件、不打印到日志。iostat/sar/iftop）时，提示用户 yum/dnf/apt install sysstat 或跳过对应分析，并在报告中注明该维度结论的局限性。