首页 › skills-review › 门牌写official的,反而是旧款

门牌写official的,反而是旧款——内容办公线第4轮:一个工位的家当普查

概述

本栏评 PPT 件已经评了三轮路线:08-29 期横比 OOXML 手术流、python-pptx 脚本流、HTML 动效流,09-25 期拆了「一件 Skill 塞一百节课」的语料库打法,09-28 期从命名语法盘过 pptx 族五件同名条目。这一期换最后一个没人用过的镜头:不比路线、不看星数,盘点同一个 PPT 工位上的家当——把货架上十份 PPT 件逐一开箱,只看一件事:除了 SKILL.md,它们各自还带了什么。核心发现有两个:其一,同一个工位上同时住着七种知识形态,从单页说明书到整族 ISO 规格书全齐;其二,门牌写着 official 的那份,家当反而比不写的那份旧一代。

全家福:一个工位,十份家当

以下全部来自本机货架的实际目录结构(~/.claude/skills/ 下逐件清点),这是比评分更硬的证据——目录不会说谎:

件名 家当清单 知识形态
pptx SKILL.md + 4 份手册(html2pptx / ooxml / pptxgenjs / editing)+ 7 个脚本 + 校验器套件 + 全套 XSD 规格书 + LICENSE 实验室型
pptx-official SKILL.md + 2 份手册 + 5 个脚本,无规格书 旧版官方快照
pptx-generator SKILL.md + references/ 五本参考书(design-system、pitfalls、pptxgenjs、slide-types、editing),零脚本 教科书型
pptx-manipulation 仅 SKILL.md 单页型
pptx-test 仅 SKILL.md 单页考卷
51xtx-ppt-writer SKILL.md + batch_ppt_generator.py + reference/template.pptx 模板填空型
ericsson-ppt-writer SKILL.md + 3 个专题脚本 + 助手脚本 + 模板 脚本堆型
ericsson-ppt-writer-v2 SKILL.md + 4 份工程文档 + 统一引擎 + 上百个选题 JSON 资产型
knowledge-to-slides SKILL.md + 2 本参考书 + 3 套模板(幻灯 / 总览 / 实验手册) 过程件型
frontend-slides SKILL.md(HTML 动效路线) 交付物异类

同样的一个用户需求——“给我做份 PPT”——十份件交出了十种完全不同的行李清单。这份清单本身就是生态成熟度的活体切片。

七种知识形态:你把本事藏在哪个文件里

拆 SKILL.md 写法本栏做过很多次,但真正决定一件 Skill 上限的,往往是知识被安放在哪个文件里。十份家当归出七种形态:

一、藏在说明书正文里(单页型)。 pptx-manipulation 和 pptx-test 只带一张 SKILL.md,全部知识压缩在正文里。优点是安装即用、零依赖、门牌命中后一次加载完;代价是知识总量有天花板——一张纸装不下 OOXML 的雷区清单。7 月 9 日那轮七件连测里 pptx-test 拿了 3 分垫底(判例存档见 09-28 期成绩表),单页形态的读写效率未必输,输在深度没有回旋层。

二、藏在参考书里(教科书型)。 pptx-generator 的目录结构是一间自习室:design-system.md 讲版式体系,pitfalls.md 专门收坑,pptxgenjs.md、slide-types.md、editing.md 各管一章。这是和官方件「footgun 数据库」同源但更温和的思路——官方把负面清单直接拍在正文里强制执行,generator 把它整理成随翻随查的参考书,把「必须读」降级成「按需读」。渐进式披露玩到第二层的样子。

三、藏在模板里(模板填空型)。 51xtx-ppt-writer 的家当是三件套:说明书、批处理脚本、一份 .pptx 模板。知识大头不在任何文本里,在模板文件的版式、母版和品牌常量里——模型的工作不是「画」,是「填」。Q3 收官对账给它的评语是「摆幅最大的一族」(3.0~4.4),原因也在这:测品牌合规它无敌,测通用性它无处可逃,因为它的全部本事都锁死在那张模板上。

四、藏在语料里(资产型)。 ericsson-ppt-writer-v2 不再赘述——09-25 期整期都在讲它:上百个选题 JSON、四份过程文档,技能是说明书,语料库才是估值。值得补的一笔是它和 v1 同架对比出的代际差:v1 目录里躺着 generate_udm_ppt.py、generate_amf_ppt.py、generate_ngap_ppt.py——一个专题一个硬编码脚本;v2 收成一个引擎加一柜子数据。从「写死的脚本」到「数据驱动的产线」,这一步跨越就是软件工程百年史在一张货架上的重演。

五、藏在规格书里(实验室型)。 这是本期最大的发现,单独开一节讲。

代际考古:两代官方件同架

货架上同时躺着两份官方 pptx 的翻版。家当对比:

pptx-official(旧)              pptx(新)
├─ SKILL.md                     ├─ SKILL.md
├─ html2pptx.md                 ├─ html2pptx.md
├─ ooxml.md                     ├─ ooxml.md
                                ├─ pptxgenjs.md        ← 新增
                                ├─ editing.md          ← 新增
├─ scripts/(5个脚本)            ├─ scripts/(7个脚本+office/子包)
└─ ooxml/scripts/(3个)          ├─ ooxml/scripts/validation/(4件校验器)
                                ├─ scripts/office/validators/(4件校验器)
                                ├─ ooxml/schemas/ 全套XSD   ← 新增
                                └─ LICENSE.txt

三点增量值得逐条说。

第一,手册从两张拆成四张。 生成走 html2pptx,改现有文件走 ooxml,新建走 pptxgenjs,编辑走 editing——09-18 期深拆官方件时总结的「生成、读、改三个动词分诊」,在这份新家当里落实成了四份手册各管一个动词。这是文件结构对工作流的直接映射:模型命中技能后不必通读,按任务翻对应分册。

第二,校验器从脚本长成了套件。 旧版只有一个 validate.py;新版把校验拆成 base、docx、pptx、redlining 四件一组,还配了 helpers(merge_runs、simplify_redlines)。redlining——修订痕迹校验——本是 docx 件的核心工艺,如今以共享包形态出现在 pptx 家当里:官方仓库正在把 office 四件套的公共能力抽成组件库,技能件开始出现「框架层」。

第三,也是最重的一项:把 ISO 标准打包进了行李。 新版家当里有整族 XSD 规格书——目录名直接写着 ISO-IEC29500-4_2016,即 ISO/IEC 29500-4:2016(OOXML 的国际标准文本),外加 ECMA 第四版 OPC 规格书和一排按年份编号的微软扩展规格书(wml-2010 一路排到 wml-sdtdatahash-2020)。这意味着 validate.py 的结构校验不是凭记忆对表,而是拿着离线标准原文逐节点核对。顺带一个可爱的化石:ECMA 目录名拼写为「fouth-edition」——少了个 r,显然是从上游源码树原样拷贝来的,连错别字都带着,恰好证明这批规格书是真实搬运而非手打。

新旧两份的增量方向可以一句话概括:官方件在把「正确性」从提示词搬进资产。 旧版靠说明书里写「注意 XX 会损坏文件」,新版直接把标准和校验器装进技能包——提示词会忘,规格书不会。

最后是命名层面的黑色幽默:门牌写着 official 的那份是旧快照,没有后缀的那份才是全量新版。两份都翻版自 anthropics/skills 官方仓库,代际判断基于家当增量(以仓库当前版本为准),但「名字含 official 未必最新」这一课,足以给所有按名字装件的读者提个醒。另一个使用痕迹:旧版目录里同时躺着 cpython-312 和 cpython-313 两份字节码缓存——这台机器上两个 Python 版本都真跑过它的脚本,是一份被用过、而不是被供着的件。

flowchart TD
    A["PPT工位: 知识放在哪"] --> B["说明书正文"]
    A --> C["参考书目录"]
    A --> D["模板文件"]
    A --> E["语料JSON"]
    A --> F["规格书XSD"]
    A --> G["考卷"]
    B --> B1["pptx-manipulation"]
    B --> B2["pptx-test"]
    C --> C1["pptx-generator 五本"]
    C --> C2["knowledge-to-slides"]
    D --> D1["51xtx 模板填空"]
    E --> E1["ericsson-v2 百课语料"]
    F --> F1["pptx 全套ISO规格书"]
    G --> G1["单页验收清单"]

评分:家当厚度不等于总分

按本栏五维口径汇总(既往判例分照录存档口径,首评件为本文新开分,均为本文主观判断):

件 功能完整度 设计质量 实战效果 上手难度 社区活跃度 综合 口径来源
pptx(官方新版) ★★★★★ ★★★★★ ★★★★☆ ★★★☆ ★★★★ 4.5 09-24 期判例
pptx-official(旧快照) ★★★★ ★★★★ ★★★★☆ ★★★☆ ★★★★ 4.2 本文按家当增量下调首评
pptx-generator ★★★★ ★★★★☆ ★★★☆ ★★★★ ★★★ 3.9 本文首评
knowledge-to-slides ★★★★ ★★★★ ★★★★ ★★★★ ★★★ 4.2 09-27 期盲盒首拆判例
ericsson-ppt-writer-v2 ★★★★★ ★★★★ ★★★★ ★★★ 不计(私房件) 4.0 09-25 期判例
51xtx-ppt-writer ★★★★ ★★★★ ★★★★ ★★★★ 不计(私房件) 4.4 Q3 对账上限口径
pptx-manipulation ★★★ ★★★ ★★★ ★★★★★ ★★★ 3.2 本文首评
pptx-test ★★★ ★★★ ★★★ ★★★★★ ★★★ 3.0 07-09 七测判例

注意一个反直觉结论:家当最厚的 pptx 综合分不是碾压性的。规格书和校验器买来的是正确率上限,付出的是依赖复杂度(LibreOffice、Poppler 工具链)和上手成本。上手难度那一列,恰恰是单页件满分、实验室型三星——货架十件,没有全能冠军,只有场景分工。

安装与上手

# 官方件(新版家当最全,推荐整包装)
git clone https://github.com/anthropics/skills.git
mkdir -p ~/.claude/skills
cp -r skills/document-skills/pptx ~/.claude/skills/pptx

# 或走 skills CLI 按件安装
npx skills add anthropics/skills --skill pptx

# 同门 docx / xlsx / pdf 换路径名即可
# 51xtx / ericsson 系为私房件无公开仓库,思路可自建:
#   模板流 = template.pptx + python-pptx 填空
#   资产流 = 统一引擎 + 选题 JSON 语料库

装完验证:对 Claude 说「把这份 PPT 的第 3 页复制一份」,看它是先 unpack 再动 XML,还是直接莽——新旧两代官方件的分水岭就在这一步。

排行榜

写在最后

这一期没评出新王者,因为家当普查的结论本来就不是一个名字,而是一张知识分布图:说明书教一次,参考书备着查,模板管品牌,语料保产能,规格书守正确性,考卷做验收。想写自己的第一个 Skill,别急着堆功能——先决定你的本事放在哪个文件里,这个决定比正文里任何一句话都长寿。至于本栏,下期换闸位,办公线就此收官存档。

参考来源

  1. anthropics/skills — 官方技能仓库 — pptx 新旧两代家当的上游源头,四件套所在路径 document-skills/
  2. 本站存档《PPT三条技术路线:办公与SEO类Skill横评》(2026-08-29,output/2026-08-29/skills-ecosystem-r4-0328.md)— 三路线首评与官方 footgun 设计的原始出处
  3. 本站存档《一件Skill塞了一百节课》(2026-09-25,output/2026-09-25/skills-ecosystem-r4-0807.md)— ericsson-ppt-writer-v2 资产层打法的判例存档
  4. 本站存档 09-28 期装机普查与成绩表(output/2026-09-28/)— pptx 族条目口径、pptx-test 七测判例与命名轴分析
  5. Claude Docs: Skills — Skills 目录约定与渐进式披露加载机制
  6. 本机货架目录实测(~/.claude/skills/ 下 pptx、pptx-official、pptx-generator、pptx-manipulation、pptx-test、51xtx-ppt-writer、ericsson-ppt-writer v1/v2、knowledge-to-slides 逐件清点)— 本文全部家当清单与代际判断的一手证据,XSD 规格书族含 ISO-IEC29500-4_2016 目录

[!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学通信知识星球海报-扫码加入