# 六件效率件，拆出四种活法 ## 概述 本栏目拆开发者效率件，代码审查、重构、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** | ## 四种范式总览 ```mermaid 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向导"] ``` 同一句「帮开发者提效」，六件给出了四种完全不同的回答。下面逐件拆，每件讲清定位、亮点、短板，最后说哪种范式该抄。 ## 逐件拆解 ### 1. pcap-analyzer：唯一的工程范本（4.2 分） 六件里唯一带真代码的。三层架构：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 这两个领域立刻无用，是件专精工具而非通用件。 ```bash # 环境准备 sudo apt install tshark # 需 3.x+ # 之后自然语言触发，例如：「分析 capture.pcap 的注册流程」 ``` ### 2. gh-cli：一部字典的两难（3.9 分） 据 skill 正文标注，版本 2.85.0（2026 年 1 月更新）。从 auth 到 pr、issue、run、release、project、codespace 全命令树铺开，连 `gh agent-task` 这种 gh 新近 agent 化的新命令都收了——维护者跟得很紧。信息密度极高，当查询手册用几乎不会失望。 问题出在范式本身：两千行级的命令罗列，没有工作流引导，没有「什么场景该用哪条」的取舍，触发一次就整本进上下文。很多条目 `gh pr --help` 本来就能查到，Skill 的增值本该是组织与取舍，它选择了不做取舍。这是字典型的两难：大全换取「一定查得到」，代价是每次都付全额上下文租金。 ```bash # Skill 本体不依赖额外安装，但需要 gh 可用 brew install gh # 或参考 skill 内附的 Linux apt 安装段 gh auth login ``` ### 3. encoding-check：流程型的完全体（3.9 分） 中文内容生产场景的刚需件：批量扫文件的编码类型、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) ``` ### 4. github-actions-skill：唯一会聊天的件（3.9 分） 名字起得像大全，实际是个窄工具：SSH 部署配置向导，帮你把 GitHub Actions 接到自己的 VPS 上。四阶段流程——一次一问收集信息（必填四项，可选项带默认值：端口默认 22、分支默认 main）、表格确认、生成配置、分步指引。 它是六件里对话工程做得最认真的：明确写死「每次只问一个问题，保持对话简洁」，这是对多轮交互最有效的单条约束。安全设计也在线：密钥用 ed25519 专门生成一对，私钥只进 GitHub Secrets，workflow 文件里全是 `${{ secrets.* }}` 引用，不落明文。生成的 deploy.yml 自称「直接可用，无需额外修改」。 短板两处：模板把 appleboy/ssh-action 钉死在 v1.0.3，好处是可复现，坏处是 CVE 来了不会自己长；rsync 模板直接带 `--delete`，生产目录里的多余文件会被同步删掉，向导全程没有一句风险提示——向导型件的通病，只管流程顺畅，不管边界警告。 ```yaml # 产物示例（节选）：.github/workflows/deploy.yml # - uses: appleboy/ssh-action@v1.0.3 # with: # host: ${{ secrets.SSH_HOST }} # key: ${{ secrets.SSH_PRIVATE_KEY }} ``` ### 5. mcp-cli：小抄的极限压缩（3.7 分） 如果 gh-cli 是字典的负面教材，这件就是字典型的正面答案。整份 SKILL.md 一张命令表、一个四步工作流（Discover 列服务 → Explore 看参数 → Inspect 看 schema → Execute 调用）、三个输出选项、一组退出码，完事。 退出码是全文最见功力的一笔：0 成功、1 客户端错、2 服务端错、3 网络错——模型拿到非零退出码就知道该改参数还是该报网络故障，不用猜。`-d` 加描述的渐进细节设计，也让「先粗后细」有了抓手。前提条件要说明：它是第三方工具 mcp-cli 的用法卡片，工具本身需自备；Skill 无版本无出处标注，维护痕迹不明。 ```bash mcp-cli # 列出所有 server 和工具 mcp-cli filesystem -d # 带描述看参数 mcp-cli filesystem/read_file '{"path": "./README.md"}' # 直接调用 ``` ### 6. notebook-fix：安全阀值得抄，其他一般（3.4 分） 修 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` 这类破坏性默认值，向导有义务在确认表里红字标出。 ```mermaid 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 和选开源库是同一个道理：先看作者有没有把「我还会继续管它」写出来。 ## 参考来源 1. [GitHub CLI 官方手册](https://cli.github.com/manual/) — gh-cli skill 正文内附的官方命令参考 2. [GitHub CLI 官方文档](https://docs.github.com/en/github-cli) — gh-cli skill 正文内附的认证与配置文档 3. 本地货架六件 SKILL.md 原文：`~/.claude/skills/` 下 gh-cli、mcp-cli、notebook-fix、encoding-check、pcap-analyzer、github-actions-skill — 本文全部评分与引文的一手材料 4. [appleboy/ssh-action](https://github.com/appleboy/ssh-action) — github-actions-skill 模板引用的 SSH 部署 Action（模板钉死版本 v1.0.3） 5. [Free5GC](https://github.com/free5gc/free5gc) — pcap-analyzer 正文声明的实测环境（AMF-MM-001 测试用例） > [!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 等场景全覆盖。