首页 › skills-review › 电信赛道首拆:规范到抓包三件套

电信赛道首拆:982份规范、439个源码文件和281条原因码

概述

本期换一条没人碰过的赛道:电信/5G。素材不是二手评测,而是对三个本机已安装 Skill 的 SKILL.md 原文直读——3gpp-5g-specs(982 份 3GPP 规范知识库)、UERANSIM(自动生成的源码知识包)、pcap-analyzer(5GC/IMS 抓包分析工具)。三个 Skill 分别代表行业知识 Skill 的三种形态:知识库型、代码库型、工具型,恰好串成一条「读规范 → 看实现 → 抓包验证」的完整研发工作流。核心发现:行业 Skill 的胜负手不在功能多少,而在「反幻觉合同」写得多严、检索方法论给得多细、踩坑记录留得多实。同名家族在本机还有 free5gc、pcap-generator、3gpp-daily-article 等 7 件,本文末尾一并给出图谱。

为什么值得看电信赛道

Skills 生态的热门榜单长期被 PPT、写作、视频占据,但电信是一个被低估的「Skill 适配度极高」的行业,原因有三:

  1. 文档密度极高:3GPP 一套 Release 18 规范上千份、动辄单本 700 页,任何人类都读不全,这正是「把知识库打包进 references/ 目录」最该发挥的场景;
  2. 反幻觉是刚需而非美德:通信协议问答里,编造一个章节号或消息流程的代价远高于一般写作场景,逼着 Skill 作者把「拒答规则」写成硬约束;
  3. 验证闭环可以自动化:规范说法对不对,抓个包就能对账——这让电信 Skill 天然分成了知识、环境、验证三层。

下面逐个拆。

评测对比表

维度(权重) 3gpp-5g-specs UERANSIM pcap-analyzer
功能完整度 25% ★★★★★ ★★★☆☆ ★★★★☆
设计质量 25% ★★★★☆ ★★☆☆☆ ★★★★☆
实战效果 20% ★★★★☆ ★★★☆☆ ★★★★☆
上手难度 15% ★★★★☆ ★★★★★ ★★★☆☆
社区活跃度 15% ★★★☆☆ ★★☆☆☆ ★★★☆☆
加权总分 4.10 2.90 3.70

说明:三者均为本机安装实例,社区活跃度只能基于 SKILL.md 内部证据(署名、验证记录、维护痕迹)评分,未引用市场榜单数据。

深拆一:3gpp-5g-specs——把「反幻觉」写成合同

定位:基于 3GPP Release 18 全系列规范的问答知识库,自称收录 982 个规范 MD 文件(2025 年 9 月从 PDF 转换),自包含于技能的 references/ 目录,覆盖 22/23/24/26/28/29/32/33/35/38 等全系列,安装后完全离线可用。

最值得抄的设计:开头不是介绍,是三条款合同。 SKILL.md 第一屏就是「重要使用约束」:

这不是姿态,它配套了执行细则:回答 Nx 接口问题必须注明「TS 23.501第6.3节」作为来源;速查表与权威规范冲突时以后者为准。更罕见的是,它把一次真实翻车写进了规则——「❌ 『N24是NEF-UDR接口』(错误,依赖了速查表)→ ✅ 『N24是V-PCF与H-PCF之间的接口』」,并在速查表上方重复一遍警告。把 bug 日志固化成系统提示里的仲裁规则,这个做法比任何「请务必准确」式的叮嘱都有效。

第二个亮点:检索方法论教到操作层。 它明确给出错误示范(预设章节号直接搜 Grep "5.7.3")和正确流程:先用关键词搜出「5091:###### 5.7.1.1 QoS Flow」这样的行号,再用 Read 按 offset 读取完整章节,还给出跨规范交叉验证法(Stage 1 需求、Stage 2 架构、Stage 3 协议三方互证)。同样是「references/ + SKILL.md」结构,这份 SKILL.md 教的是怎么查,而不是仅仅罗列有什么。

两处扣分:一是「技能学习状态」段落用 ✅/🔄/⏳ 标注各系列「已学习/学习中/待学习」——SKILL.md 是静态文件,这些状态不会自己更新,时间一长就从导航信息变成误导;二是数字不一致,前文说 982 个文件,后文又说「全部 1307+ 本规范」,暴露手工维护的接缝。另外 KPI 部分坦承「TS 32 系列文件不完整,必须如实回答没有查找到」——这种按领域声明知识边界的写法反而是加分项,可惜和状态段落自相矛盾。

安装(本机实例直拷即可):

cp -r <来源目录> ~/.claude/skills/3gpp-5g-specs
# 验证
ls ~/.claude/skills/3gpp-5g-specs/references/ | wc -l

深拆二:UERANSIM——自动生成的正反面

定位:由 Skill Seeker(SKILL.md 页脚署名「Generated by Skill Seeker | Codebase Analyzer with C3.x Analysis」)对 UERANSIM 开源 5G 模拟器仓库自动分析生成的代码库知识包——439 个 C++ 文件、309 篇项目文档、14 个配置文件 512 项设置,全部分析产物放进 references/ 的六个子目录(api_reference、dependencies、patterns、config_patterns、architecture、documentation)。

正面价值:几分钟内把一个陌生 C++ 仓库变成可导航知识包,上手难度五星。对「接手别人遗留项目」这种场景,生成器这条路线的工程意义是真实的。

反面教材也是它。SKILL.md 正文几乎全是「报告的目录页」:架构一节只有一行「Service Layer Pattern (confidence: 0.75)」;配置分析写着「Patterns Detected: 0」「Configuration Types: unknown」——空结果原样入库;连 C2.5、C3.7 这类内部分析流水线的任务编号都直接漏进了提示词。最致命的是这一行:

Path: C:\Users\nrgc\.claude\skills\UERANSIM

Windows 绝对路径硬编码在正文里——这份 Skill 是在别人机器上生成后拷贝来的,换一台机器,正文第一屏就是一条失效路径。它和 3gpp-5g-specs 是同一副骨架(大 references/ + 一份 SKILL.md),对照之下结论清晰:SKILL.md 的价值密度决定知识包的成色,一个给方法论,一个只给清单。

安装:

cp -r <来源目录> ~/.claude/skills/UERANSIM
# 建议顺手修掉正文里的硬编码路径

深拆三:pcap-analyzer——工具型 Skill 的标准姿势

定位:通过自然语言分析 PCAP 报文文件,聚焦 5G 核心网(NGAP/N1 NAS/PFCP/GTP-U)与 IMS(SIP/SDP),外加 HTTP/DNS/TLS 等 30 余种传统协议。核心资产是 Python 脚本层(scripts/analyzer_5g.py)加三份协议知识库:5GMM 原因码 136 条、5GSM 原因码 105 条、SIP 响应码 40+ 条——这 281 条逐条映射的码表,正是通用模型最容易「半记半编」的地方,属于真正的护城河。

设计上的三个可学细节:

  1. SKILL.md 写成 API 文档:「快速开始」直接给 import 和方法签名(flow_analyzer.analyze_registration_flow("capture.pcap")),常用查询用中英双语自然语言列表(「分析注册流程」)——这份列表同时充当触发面和用法说明,一物两用;
  2. 踩坑记录全是代价换来的:明确写「使用 -V verbose 模式而非 -T fields 模式」(TShark 老手才知道这两种模式对 5G 协议层解析的差异)、状态符号用「ASCII 的 [OK]/[FAIL](Windows 兼容)」、IP 方向判断「127.0.0.18=gNB, 127.0.0.1=AMF,可自定义」——最后这条说明它是照着 free5gc 默认拓扑调过的,且有「已在 Free5GC AMF-MM-001 测试用例验证」的实测背书;
  3. 依赖声明独立成节:Wireshark/TShark 3.x+、Python 3.8+,安装前就知道要装什么——很多 Skill 死在第一步「环境装不齐」,这两行字值回票价。

短板:输出格式固定为 Markdown 消息序列表,定制汇总视图要自己写代码;原因码库是静态表,规范版本演进时需要人手同步。

安装:

cp -r <来源目录> ~/.claude/skills/pcap-analyzer
# 依赖:先装 Wireshark/TShark 与 Python 3.8+
tshark --version

三件套工作流

三者组合起来是一条「规范 → 实现 → 报文」的对账闭环:

flowchart LR
    Q["电信问题进场"] --> S["3gpp-5g-specs 查规范原文"]
    Q --> U["UERANSIM 查源码实现"]
    S --> P["pcap-analyzer 抓包验证"]
    U --> P
    P --> V{"输出与规范一致?"}
    V -->|一致,出结论| R["可信答案"]
    V -->|不一致,找偏差| D["定位实现问题"]

值得强调:这条流水线里每一环的 SKILL.md 都不假设下一环存在——它们各自独立可用,组合是免费收获。这是好 Skill 的共性:原子能力 + 意外的可组合性。

电信 Skill 家族图谱

本机注册表里同族 Skill 还有 7 件(从命名看定位,未逐一深读):

mindmap
  root((电信Skill家族))
    知识层
      3gpp-5g-specs 规范库
    环境层
      UERANSIM 源码包
      free5gc 核心网
    验证层
      pcap-analyzer 分析
      pcap-generator 造包
      pcap-modifier 改包
    出口层
      3gpp-daily-article
      3gppspec-to-video
      telecom-news-digest
    学习层
      telecom-learning-coach
      telecom-learning-planner

一个行业在 Skills 形态上的完整光谱:知识入库、环境封装、流量造改、内容出口、学习陪练——都已有人动手。验证层的「生成/修改/分析」三件尤见巧思:造包对应测试注入,改包对应异常用例构造,分析对应排障,覆盖了协议测试的写读两侧。

推荐排行榜

给想写行业 Skill 的你:三条可复用结论

  1. 反幻觉要写成合同,不是建议。拒答条件、来源标注格式、冲突仲裁规则(哪个文档说了算)、按领域声明的知识边界——四件套前置在 SKILL.md 第一屏。行业知识 Skill 最大的风险从来不是「不知道」,而是「自信地编」。
  2. SKILL.md 是方法论,不是目录页。指向 references/ 之前,先回答「怎么查」:两步检索法(先关键词定位、再按行号读取)、交叉验证路径、错误示范对照。只罗列文件清单的知识包,模型用起来和直接 ls 没区别。
  3. 踩坑记录是最高价值段落。verbose 模式陷阱、ASCII 符号兼容、可自定义的 IP 映射——这些用调试时间换来的细节,是通用模型不可能自己想对的地方,也是一个 Skill 相对于「裸模型 + 搜索」的真正增量。反过来,警惕三类腐烂信号:不会更新的「学习状态」、对不上的数字、硬编码的绝对路径。

参考来源

  1. 本机 Skill 实例 /home/gprshome/.claude/skills/3gpp-5g-specs/SKILL.md — 982 份规范知识库原文,本文主要引文出处
  2. 本机 Skill 实例 /home/gprshome/.claude/skills/UERANSIM/SKILL.md — Skill Seeker 自动生成的代码库知识包原文
  3. 本机 Skill 实例 /home/gprshome/.claude/skills/pcap-analyzer/SKILL.md — 5GC/IMS 抓包分析工具原文,含 Free5GC AMF-MM-001 验证记录
  4. 3GPP 官网 https://www.3gpp.org/ — 上述规范知识库引用的权威规范出处(TS 23.501 等)
  5. Free5GC 开源项目 — pcap-analyzer 自述的验证环境(AMF-MM-001 测试用例),本项目 SKILL.md 内提及

[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入