本栏目拆开发者效率件，代码审查、重构、CI值守、TDD、调试这些正座都已经逐一拆过。这一轮换第二梯队：不替你写码、不替你审码，但在你干活路上搬石头的那批件——管 GitHub 的、管 MCP 工具的、修坏文件的、查网络包的、配部署的。六件全部来自本地已装货架的一手 SKILL.md 原文，拆完发现一个意外收获：六件恰好落进四种截然不同的 SKILL.md 写法范式——字典型、流程型、工程型、向导型。看懂这四种，你自己写第一个 Skill 时就知道该抄谁的作业。
先交代方法：本轮榜单类信息源缺席（在线热度无法核验），Star 数与安装量一律缺席，「社区活跃度」维度改按维护痕迹估算（版本标注、迭代记录、实测声明）；gh-cli 的版本号等单一来源信息，均注明「据 skill 正文标注」。
| Skill | 范式 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 活跃 15% | 综合 |
|---|---|---|---|---|---|---|---|
| pcap-analyzer | 工程型 | ★★★★★ | ★★★★★ | ★★★★ | ★★★ | ★★★ | 4.2 |
| gh-cli | 字典型·大全 | ★★★★★ | ★★★ | ★★★★ | ★★★★ | ★★★ | 3.9 |
| encoding-check | 流程型 | ★★★★ | ★★★★ | ★★★★ | ★★★★★ | ★★ | 3.9 |
| github-actions-skill | 向导型 | ★★★ | ★★★★★ | ★★★★ | ★★★★★ | ★★ | 3.9 |
| mcp-cli | 字典型·小抄 | ★★★ | ★★★★★ | ★★★★ | ★★★★ | ★★ | 3.7 |
| notebook-fix | 流程型 | ★★★ | ★★★★ | ★★★ | ★★★★★ | ★★ | 3.4 |
flowchart TD
A["六件开发效率件"] --> B["字典型"]
A --> C["流程型"]
A --> D["工程型"]
A --> E["向导型"]
B --> B1["gh-cli 大全"]
B --> B2["mcp-cli 小抄"]
C --> C1["notebook-fix"]
C --> C2["encoding-check"]
D --> D1["pcap-analyzer"]
E --> E1["gh-actions向导"]
同一句「帮开发者提效」，六件给出了四种完全不同的回答。下面逐件拆，每件讲清定位、亮点、短板，最后说哪种范式该抄。
六件里唯一带真代码的。三层架构：SKILL.md 本体是一份 API 说明书，开头就给 from scripts.analyzer import PCAPAnalyzer 的调用示例；scripts/ 里躺着完整版 analyzer_5g.py 和轻量版 registration_analyzer.py 两条产品线；references/ 里放 5G 协议字段详解和 TShark 命令参考，按需加载，不占平时上下文。
最值钱的是知识库：5GMM 原因码 136 条、5GSM 原因码 105 条、SIP 响应码 40 多条，合计 240 余条领域硬知识写死在代码里。模型不需要「知道」Illegal UE 是什么，查表就行。还有两处细节见功力：解析选了 TShark 的 -V verbose 模式而非 -T fields，因为 5G/IMS 协议层在字段模式下取不全；输出符号用 [OK]/[FAIL] 而非 ✓✗，正文专门注明「Windows 兼容」。甚至有一节「当前状态」老实交代哪些已实现、在哪个 Free5GC 测试用例（AMF-MM-001）上验证过——Skill 写到敢附实测记录的，货架上罕见。
短板也明显：依赖本机装 Wireshark/TShark 3.x+ 和 Python 3.8+，出了 5G/IMS 这两个领域立刻无用，是件专精工具而非通用件。
# 环境准备
sudo apt install tshark # 需 3.x+
# 之后自然语言触发，例如：「分析 capture.pcap 的注册流程」
据 skill 正文标注，版本 2.85.0（2026 年 1 月更新）。从 auth 到 pr、issue、run、release、project、codespace 全命令树铺开，连 gh agent-task 这种 gh 新近 agent 化的新命令都收了——维护者跟得很紧。信息密度极高，当查询手册用几乎不会失望。
问题出在范式本身：两千行级的命令罗列，没有工作流引导，没有「什么场景该用哪条」的取舍，触发一次就整本进上下文。很多条目 gh pr --help 本来就能查到，Skill 的增值本该是组织与取舍，它选择了不做取舍。这是字典型的两难：大全换取「一定查得到」，代价是每次都付全额上下文租金。
# Skill 本体不依赖额外安装，但需要 gh 可用
brew install gh # 或参考 skill 内附的 Linux apt 安装段
gh auth login
中文内容生产场景的刚需件：批量扫文件的编码类型、BOM、中文兼容性、特殊 Unicode 字符、换行符五件事，GBK 老文档混进 UTF-8 仓库这类事故在动手前就能拦住。报告模板画成 ASCII 表格，哪些转换、哪些手动，一目了然。
设计上它比同族的 notebook-fix 多长了两截：一截是「预防建议」，告诉模型生成新文件时一律显式 encoding='utf-8'——把修复件往源头推了一步；另一截更罕见，正文里画了一张集成工作流，把自己排在 /pptx-test 等其他 Skill 前面当质检工序。Skill 之间互相编排，这是货架上少见的意识。自动转换同样带 .bak 备份和 y/n 确认。缺点：同样存在正文格式瑕疵（加粗标记断裂），且无版本无出处。
/encoding-check **/*.md
# 报告后逐个询问：Convert doc2.md from GBK to UTF-8? (y/n)
名字起得像大全，实际是个窄工具：SSH 部署配置向导，帮你把 GitHub Actions 接到自己的 VPS 上。四阶段流程——一次一问收集信息（必填四项，可选项带默认值：端口默认 22、分支默认 main）、表格确认、生成配置、分步指引。
它是六件里对话工程做得最认真的：明确写死「每次只问一个问题，保持对话简洁」，这是对多轮交互最有效的单条约束。安全设计也在线：密钥用 ed25519 专门生成一对，私钥只进 GitHub Secrets，workflow 文件里全是 ${{ secrets.* }} 引用，不落明文。生成的 deploy.yml 自称「直接可用，无需额外修改」。
短板两处：模板把 appleboy/ssh-action 钉死在 v1.0.3，好处是可复现，坏处是 CVE 来了不会自己长；rsync 模板直接带 --delete，生产目录里的多余文件会被同步删掉，向导全程没有一句风险提示——向导型件的通病，只管流程顺畅，不管边界警告。
# 产物示例（节选）：.github/workflows/deploy.yml
# - uses: appleboy/[email protected]
# with:
# host: ${{ secrets.SSH_HOST }}
# key: ${{ secrets.SSH_PRIVATE_KEY }}
如果 gh-cli 是字典的负面教材，这件就是字典型的正面答案。整份 SKILL.md 一张命令表、一个四步工作流（Discover 列服务 → Explore 看参数 → Inspect 看 schema → Execute 调用）、三个输出选项、一组退出码，完事。
退出码是全文最见功力的一笔：0 成功、1 客户端错、2 服务端错、3 网络错——模型拿到非零退出码就知道该改参数还是该报网络故障，不用猜。-d 加描述的渐进细节设计，也让「先粗后细」有了抓手。前提条件要说明：它是第三方工具 mcp-cli 的用法卡片，工具本身需自备；Skill 无版本无出处标注，维护痕迹不明。
mcp-cli # 列出所有 server 和工具
mcp-cli filesystem -d # 带描述看参数
mcp-cli filesystem/read_file '{"path": "./README.md"}' # 直接调用
修 Jupyter Notebook 的五类常见病：导入语句写坏、代码误进 markdown 格、JSON 编码、Python 语法、单元格格式。执行流程用检查清单写法（□ JSON 校验、□ 导入扫描、□ 类型检查、□ 语法检查），并规定「报告所有问题 → 询问是否修复 → 修复前备份 .bak → 修复后验证可加载」。把安全阀写进流程，是对「让 Agent 动手改文件」这件事最起码的敬畏，这一点值得所有修复件抄。
但除了安全阀，架子偏虚：没有脚本，五类检查全靠模型现场自觉执行，「扫描」「验证」能否严格发生，取决于模型当天的自觉性。正文还有明显的格式瑕疵——** malformed_imports ** 加粗标记断裂、清单序号排版错乱，说明作者没做过一遍交付前自检。功能覆盖也浅，正文自己承认「严重损坏的文件需要手动处理」。
/notebook-fix **/*.ipynb
# 输出示例：⚠ Malformed import: `from langchain impor xxx`
# 修复前自动备份为 *.bak，确认后执行
把六件放回四种范式，每种范式的第一性差异就浮出来了。
字典型赌「上下文换确定性」。 大全（gh-cli）赌你宁付租金也要查得到，小抄（mcp-cli）赌一张表就够。判断该抄哪边的标准很朴素：看目标工具自不自带好用的 --help。gh 的帮助系统本身很完备，Skill 应该做的是「场景 → 命令」的筛选层，而不是复读命令树；mcp-cli 工具几乎没有文档，Skill 就是文档本体，小抄反而是唯一正确形态。
流程型赌「模型会照清单办事」。 notebook-fix 和 encoding-check 都不带脚本，把检查项、报告模板、确认门槛写成流程，指望模型逐步照办。这类件的生死线在安全阀：备份、确认、验证三件套齐不齐。encoding-check 多出的「预防建议」和「跨 Skill 编排」说明流程型还有上半场可打——从修下游往守上游走。
工程型赌「代码比提示词可靠」。 pcap-analyzer 是分水岭：能把逻辑写进 Python 的绝不写进散文，SKILL.md 退位成 API 说明书，知识查表不靠记忆，还敢附实测记录。代价是重量和维护成本，但换来的是六件里唯一不依赖模型发挥的确定性。
向导型赌「一次一问能驯服复杂配置」。 github-actions-skill 把一张部署配置表单拆成带默认值的对话流，是对「表单类任务对话化」的标准解法。它缺的不是流程而是警告——--delete 这类破坏性默认值，向导有义务在确认表里红字标出。
flowchart TD
A["pcap-analyzer 三层架构"] --> B["SKILL.md 说明书"]
A --> C["scripts 层"]
A --> D["references 层"]
C --> C1["analyzer_5g 完整版"]
C --> C2["registration 轻量版"]
D --> D1["5G协议字段"]
D --> D2["TShark命令"]
C1 --> E["原因码知识库 240余条"]
E --> F["消息序列表输出"]
综合榜：pcap-analyzer（4.2）＞ gh-cli ＝ encoding-check ＝ github-actions-skill（3.9）＞ mcp-cli（3.7）＞ notebook-fix（3.4）
设计质量榜：github-actions-skill（交互工程最完整）＞ pcap-analyzer（架构最重）＞ mcp-cli（单位上下文产出最高）＞ encoding-check ＝ notebook-fix（安全阀齐全但有格式瑕疵）＞ gh-cli（无组织无取舍）
功能完整度榜：gh-cli ＝ pcap-analyzer（5 星，一个全一个深）＞ encoding-check ＞ mcp-cli ＝ github-actions-skill ＝ notebook-fix
新手上手榜：notebook-fix ＝ encoding-check ＝ github-actions-skill（触发即用）＞ gh-cli ＝ mcp-cli（需自备 CLI 工具）＞ pcap-analyzer（需 TShark + 协议背景）
值得抄的三个设计：pcap-analyzer 的「SKILL.md 当 API 说明书 + 参考文档按需加载」；github-actions-skill 的「一次一问 + 默认值策略」；mcp-cli 的「退出码语义表」。
六件里四件无版本号、无出处、无更新记录——本地技能货架的「无主件」问题比市场缺货更值得警惕：装的时候都香，出事的时候找不到人。有维护痕迹的两件（据正文标注的 gh-cli v2.85.0、带实测声明的 pcap-analyzer），恰好也是综合分前两名。选 Skill 和选开源库是同一个道理：先看作者有没有把「我还会继续管它」写出来。
~/.claude/skills/ 下 gh-cli、mcp-cli、notebook-fix、encoding-check、pcap-analyzer、github-actions-skill — 本文全部评分与引文的一手材料[!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 等场景全覆盖。