tencentos-expert

name	tencentos-expert
description	TencentOS Server 全栈运维诊断，根据用户的自然语言描述，自动识别需要的能力接口，查询能力实现，使用具体能力解决客户问题。覆盖磁盘空间/分区/文件系统/LVM/健康检测、网络连通性/丢包/延迟排查、CPU火焰图/系统调用热点/调度延迟/中断均衡/文件IO延迟/进程IO追踪分析、内存泄漏/OOM诊断、系统日志/服务管理/时间同步/软件包/软件源管理、kdump配置与故障排查、等保三级安全基线检查与加固、CVE漏洞查询、产品文档实时查询。共24项能力，渐进式按需加载。触发词：磁盘满、磁盘空间、分区、格式化、挂载、fstab、LVM、扩容、SMART、坏块、ping不通、端口不通、DNS、丢包、延迟、网络慢、RTT、火焰图、CPU热点、perf、系统调用、调度延迟、中断不均衡、软中断、文件IO慢、fsync慢、page cache、IO延迟、进程IO、iotop、内存泄漏、OOM、进程被杀、内存不足、日志、journalctl、dmesg、服务启动失败、systemctl、时间不对、NTP、chrony、时区、yum源、dnf、pip源、npm源、软件包版本、安全更新、CVE、kdump、vmcore、crashkernel、等保、安全加固、安全基线、TencentOS文档、版本信息、CentOS迁移。
description_zh	TencentOS 服务器运维诊断助手，排查磁盘/网络/CPU/内存/安全问题
description_en	TencentOS Server ops assistant for disk, network, CPU, memory & security diagnostics
version	2.0.1

TencentOS Server 全栈运维诊断

覆盖 24 项运维能力，按需加载，不撑爆上下文。

工作流程

Step 0: 安装依赖工具（首次执行）

当触发本 skill 时，首先执行以下命令安装所有诊断工具依赖（无论成功或失败，都继续执行后续步骤）：

# 性能分析工具
dnf install -y perf-prof perf bpftrace sysstat || true
# 网络诊断工具
dnf install -y tcpdump nettrace mtr ethtool iperf3 dropwatch || true
# 存储诊断工具
dnf install -y smartmontools nvme-cli fio blktrace iotop || true
# 内存与调试工具
dnf install -y valgrind bcc-tools gdb crash || true
# 系统调用与进程追踪
dnf install -y strace lsof cflow || true
# 系统服务工具
dnf install -y kexec-tools chrony || true

说明：

• 使用 || true 确保即使部分包安装失败也不中断流程
• 安装完成后继续执行 Step 1

Step 1: 理解用户意图

分析用户的自然语言请求，从下方 能力索引表 中匹配 1~3 个最相关的模块。

匹配策略：

1. 先根据关键词缩小到大类（如"磁盘满" → 磁盘与存储）
2. 再在子模块中定位具体能力（如"磁盘满" → disk-space）
3. 如果用户意图模糊，选择最可能的模块并在诊断中确认

Step 2: 加载模块详细文档

找到目标模块后，必须先读取对应的 references/ 文件，获取完整的诊断步骤和命令参考。

加载方式：

Read: references/<module-id>.md

例如用户问"磁盘空间不足"：

Read: references/disk-space.md

Step 3: 执行诊断

按照模块文档中的诊断步骤执行。遵循以下通用原则：

安全原则

⚠️ AI 只执行诊断命令（查看、分析），不自动执行任何破坏性操作。

涉及数据变更的操作（格式化、删除、重启服务、修改配置等）仅作为参考提供给用户，由用户自行判断和手动执行。

通用信息收集（首次连接时执行一次）

uname -r && cat /etc/os-release | head -3
uptime && free -h
df -h | head -10

TencentOS 版本差异速查

操作	TencentOS 2	TencentOS 3/4
包管理器	yum	dnf（yum 为别名）
默认防火墙	iptables	firewalld
网络管理	network-scripts	NetworkManager
NTP 服务	ntpd	chronyd
连接查看	netstat	ss
日志轮转	cron 触发	systemd timer
cgroup	v1	v1(TS3) / v2(TS4)
性能工具安装	yum install	dnf install

Step 4: 输出结果

按照模块文档中定义的报告格式输出诊断结论和建议。

---

能力索引（24 项）

磁盘与存储（5 项）

模块 ID	能力	匹配关键词	文档路径
disk-space	磁盘空间分析与清理	磁盘满、空间不足、No space、inode、du、df、日志清理	references/disk-space.md
disk-partition	磁盘分区管理	分区、fdisk、parted、GPT、MBR、新磁盘	references/disk-partition.md
disk-filesystem	文件系统管理	格式化、挂载、fstab、fsck、mkfs、ext4、xfs	references/disk-filesystem.md
disk-lvm	LVM 逻辑卷管理	LVM、扩容、lvextend、pvcreate、快照	references/disk-lvm.md
disk-health	磁盘健康检测	SMART、坏块、磁盘寿命、NVMe、I/O error	references/disk-health.md

网络（3 项）

模块 ID	能力	匹配关键词	文档路径
network-check	网络连通性诊断	ping不通、端口不通、DNS、防火墙、路由、ssh连不上	references/network-check.md
network-latency	网络丢包与延迟	丢包、延迟高、RTT、网络慢、重传、ethtool、nettrace、网络抖动、TCP重传、Ring Buffer、softnet、conntrack满、conntrack table full、drop reason、eBPF网络诊断、报文跟踪、协议栈延迟、ping延迟正常但应用慢、传输速度慢、首次连接慢、ARP、拥塞窗口、BDP、TCP缓冲区、Nagle、偶发延迟、持续延迟、时段型延迟、网卡错误、rx dropped、吞吐低	references/network-latency.md（主入口，自动路由到丢包/延迟子文件）
—	丢包排查子文件	Ring Buffer溢出、softnet backlog溢出、conntrack满、kfree_skb、dropwatch	references/network-packet-loss.md
—	延迟排查子文件	mtr逐跳、TCP拥塞恢复、bufferbloat、队列延迟、softirq积压、GRO、ARP解析延迟	references/network-latency-diag.md

性能分析（7 项）

模块 ID	能力	匹配关键词	文档路径
cpu-flamegraph	CPU 火焰图	火焰图、CPU热点、perf-prof profile、调用栈、Java进程CPU高、JVM性能、JIT、进程CPU占用高、nginx热点、D状态、进程阻塞、task-state、dwarf栈回溯、内核态热点、用户态热点、kmalloc调用路径、缺页异常、flamegraph.pl、folded文件、SVG火焰图、优化前后对比、perf-prof安装、FlameGraph安装	references/cpu-flamegraph.md
syscall-hotspot	系统调用热点	系统调用慢、strace、perf trace、syscall、futex延迟、epoll_wait延迟、系统调用报错、errno、IO系统调用、进程hang住、系统调用频率、系统调用耗时	references/syscall-hotspot.md
sched-latency	进程调度延迟	调度延迟、rundelay、抢占、唤醒延迟、P99延迟毛刺、cgroup CPU限流、CPU quota、RD状态、NUMA调度、进程响应慢但CPU不高、容器变慢、调度延迟监控	references/sched-latency.md
irq-balance	中断均衡排查	软中断、硬中断、中断不均、ksoftirqd、RSS哈希不均、NET_RX集中、网络吞吐上不去、网卡队列、RPS、RFS、irqbalance、hrcount、softirqs、中断亲和性、ethtool队列配置	references/irq-balance.md
fs-latency	文件系统IO延迟	文件IO慢、fsync慢、page cache、ext4慢、t-ops	references/fs-latency.md
file-io-trace	进程文件IO追踪	进程IO高、iowait、IO追踪、fd泄漏	references/file-io-trace.md
oom-killer	OOM 事件诊断	OOM、进程被杀、内存不足、oom-killer、cgroup内存限制、Memory cgroup out of memory、page allocation failure、kswapd、Swap耗尽、oom_score_adj、多进程内存竞争	references/oom-killer.md

内存（1 项）

模块 ID	能力	匹配关键词	文档路径
memory-leak	内存泄漏诊断	内存泄漏、RSS增长、内存不释放、memleak、VmRSS持续增长、VmAnon增长、Private_Dirty、Pss、SUnreclaim、内核slab泄漏、文件描述符泄漏、fd_count增长、内存碎片、Java堆泄漏、jmap、OOM预测	references/memory-leak.md

系统管理（5 项）

模块 ID	能力	匹配关键词	文档路径
system-log	系统日志分析	日志、journalctl、dmesg、报错、日志清理	references/system-log.md
service-status	服务状态管理	服务起不来、systemctl、启动失败、开机自启	references/service-status.md
time-sync	时间同步管理	时间不对、NTP、chrony、时区、时间同步	references/time-sync.md
package-version	软件包版本管理	软件版本、安全更新、升级、rpm、dnf	references/package-version.md
repo-source	软件源配置	yum源、dnf源、pip源、npm源、换源、镜像	references/repo-source.md

安全（2 项）

模块 ID	能力	匹配关键词	文档路径
security-baseline	等保三级安全加固	等保、安全加固、安全基线、GB/T 22239、身份鉴别、访问控制、安全审计、入侵防范、SELinux加固、SSH加固、密码策略、账户管理、防火墙配置、check模式、harden模式、R1高风险、安全检查	references/security-baseline.md
tencentos-cve-query	CVE 漏洞查询	CVE、漏洞、安全公告、TSSA、OCSA、OpenCloudOS安全公告、批量CVE查询、TS2漏洞、TS3漏洞、TS4漏洞、OC7漏洞、OC8漏洞、OC9漏洞	references/tencentos-cve-query.md

故障恢复（1 项）

模块 ID	能力	匹配关键词	文档路径
kdump-check	kdump 配置与排查	kdump、vmcore、crashkernel、panic、crash	references/kdump-check.md

产品文档（1 项）

模块 ID	能力	匹配关键词	文档路径
tencentos-docs	产品文档实时查询	TencentOS版本、维护周期、CentOS迁移、产品特性	references/tencentos-docs.md

---

文档路径映射（完整）

模块 ID	references/ 路径	scripts/ 路径
disk-space	references/disk-space.md	—
disk-partition	references/disk-partition.md	—
disk-filesystem	references/disk-filesystem.md	—
disk-lvm	references/disk-lvm.md	—
disk-health	references/disk-health.md	—
network-check	references/network-check.md	—
network-latency	references/network-latency.md + references/network-packet-loss.md + references/network-latency-diag.md + references/network-nettrace.md + references/network-faq-latency.md + references/network-faq-packet-loss.md	scripts/network-latency-monitor.sh
cpu-flamegraph	references/cpu-flamegraph.md + references/cpu-flamegraph-perf.md + references/flamegraph-install.md	—
syscall-hotspot	references/syscall-hotspot.md	—
sched-latency	references/sched-latency.md	scripts/sched-latency-monitor.sh
irq-balance	references/irq-balance.md + references/irq-balance-perf.md	—
fs-latency	references/fs-latency.md	scripts/fs-latency-collect.sh, scripts/install-deps.sh
file-io-trace	references/file-io-trace.md	scripts/file-io-trace.sh
oom-killer	references/oom-killer.md + references/oom-kernel-patterns.md + references/oom-metrics-guide.md

---

场景快速导航（按问题现象路由）

当用户描述问题现象而非直接使用关键词时，用下表定位模块：

问题现象	首选模块	备选模块
服务 CPU 跑满，不知道热点在哪	cpu-flamegraph	—
Java/Python/Node.js 进程 CPU 高	cpu-flamegraph（加载 guide 中 Java 案例）	—
进程卡住不动，ps 看到 D 状态	cpu-flamegraph（task-state 分析器）	fs-latency
某个 CPU 的 %soft 持续偏高，其他 CPU 空闲	irq-balance	—
网络吞吐上不去，但整体 CPU 还有余量	irq-balance	network-latency
ping 延迟正常，但应用响应慢	network-latency（延迟域 Module 3/6）	syscall-hotspot
网络延迟偶尔飙高，平时正常	network-latency（偶发型 M-2）	sched-latency
TCP 重传率高	network-latency（延迟域）	—
连接跟踪表满，新连接被丢弃	network-latency（丢包域 Module 6）	—
进程响应变慢，但 CPU/内存不高	sched-latency	syscall-hotspot
容器 P99 延迟飙高，CPU 使用率正常	sched-latency（cgroup CPU quota）	—
某接口延迟 P99/max 偶发异常高	syscall-hotspot（futex/epoll_wait 毛刺）	sched-latency
可用内存持续下降，进程内存不释放	memory-leak	—
Java 进程内存高，GC 后不回落	memory-leak（JVM 堆泄漏场景）	oom-killer
进程突然被杀，不知道为什么	oom-killer	—
cgroup 内容器内 OOM，但宿主机内存充足	oom-killer（cgroup OOM 场景）	—

---

文档完整导航地图

所有 references/ 文件的职责和加载时机，确保每个文件都有明确的到达路径：

主诊断文档（直接由能力索引触发）

文件	职责	触发时机
disk-space.md	磁盘空间分析与清理完整流程	磁盘满、inode 不足
disk-partition.md	分区创建/管理流程	新磁盘、分区扩容
disk-filesystem.md	文件系统格式化/挂载/修复	mkfs、fsck、fstab 问题
disk-lvm.md	LVM 逻辑卷操作	扩容、快照、pvresize
disk-health.md	SMART 检测、坏块扫描	磁盘故障预测
network-check.md	连通性逐层排查	ping 不通、端口不通
network-latency.md	丢包与延迟诊断入口（含路由规则）	丢包、延迟高
cpu-flamegraph.md	火焰图采样与生成主流程	CPU 热点、火焰图
syscall-hotspot.md	系统调用采集与分析主流程	系统调用慢、strace
sched-latency.md	调度延迟采集与分析主流程	调度延迟、唤醒延迟
irq-balance.md	中断均衡诊断主流程	软中断不均、NET_RX 集中
fs-latency.md	文件系统 IO 延迟诊断	fsync 慢、ext4 慢
file-io-trace.md	进程 IO 追踪	进程 IO 高、fd 泄漏
oom-killer.md	OOM 事件分析主流程	进程被杀、内存不足
memory-leak.md	内存泄漏诊断主流程	RSS 增长、内存不释放
system-log.md	系统日志分析	dmesg 报错、journalctl
service-status.md	服务状态与启动排查	systemctl 失败
time-sync.md	时间同步配置与排查	时间不对、NTP
package-version.md	软件包版本与更新管理	升级、安全更新
repo-source.md	软件源配置与切换	yum 源、换源
security-baseline.md	等保三级检查与加固主流程	等保、安全加固

子流程/工具参考文档（由主文档内部导航触发）

文件	职责	触发时机
network-packet-loss.md	丢包域完整诊断流程（Module 1~7）	network-latency.md 路由到丢包场景
network-latency-diag.md	延迟域完整诊断流程（Module 1~6）	network-latency.md 路由到延迟场景
network-nettrace.md	nettrace 工具完整用法参考	需要 nettrace 丢包监控/故障诊断/延迟分析时
network-faq-latency.md	延迟域 FAQ + 操作参考 + 命令速查	延迟诊断中需要 FAQ 解答或配置参考时
network-faq-packet-loss.md	丢包域 FAQ + 操作参考 + 命令速查	丢包诊断中需要 FAQ 解答或配置参考时
cpu-flamegraph-guide.md	火焰图使用指南（含 Java/D状态案例）	需要用户友好的操作指引，或遇到 Java/D状态场景
cpu-flamegraph-perf.md	perf 原生三步生成法（高级用户）	perf-prof 不可用时的降级方案
cpu-flamegraph-examples.md	常用触发场景示例 Prompt	用户描述的场景不易直接匹配关键词时参考
flamegraph-install.md	FlameGraph 工具安装指南	用户需要安装 flamegraph.pl 时
irq-balance-guide.md	中断均衡六步排查指南（含案例）	需要用户友好的操作指引
irq-balance-perf.md	perf-prof 中断分析命令参考	执行 hrcount/multi-trace/profile 命令时
irq-balance-examples.md	中断均衡场景示例	场景匹配参考
sched-latency-guide.md	调度延迟使用指南（含案例）	需要用户友好的操作指引，或 cgroup 限流场景
syscall-hotspot-guide.md	系统调用分析使用指南（含案例）	需要用户友好的操作指引，或 epoll/futex 场景
memory-leak-indicators.md	内存泄漏判定指标知识库	分析 VmRSS/VmAnon/SUnreclaim 等指标时
memory-leak-guide.md	内存泄漏排查指南	需要用户友好的操作指引
oom-kernel-patterns.md	OOM 日志特征库与根因分类	解析 dmesg OOM 日志时
oom-metrics-guide.md	OOM 诊断指标说明	分析内存指标与 OOM 关联时

---

重要注意事项

1. 不要一次性加载所有 references/——只加载用户问题匹配的 1~3 个模块文档
2. 脚本路径替换规则：文档中出现 <SKILL_DIR> 的地方，替换为本 skill 目录的实际绝对路径（即 SKILL.md 所在目录）
3. perf-prof 优先：性能分析类模块优先使用 perf-prof，不可用时按文档中的降级方案使用 perf 原生命令
4. 索引中找不到匹配时：可用 Grep 在 references/ 目录中搜索用户描述的关键词
5. 多个模块关联时：按主要问题加载主模块，相关模块的文档路径在每个模块末尾的"相关技能"中列出