首页 › skills-review › 装机层半年地层:只进不出的证据

装机层半年地层:只进不出的证据

概述

本期是生态周报,先交代观测口径:外部榜单通道本期受限,新上架名单与星数变动无法给出,泛浏览也不做——与其报一个核不了的榜单,不如换一层数据。本期用「地层法」做周报:一台真实机器上,2026 年 4 月 17 日的一次手动备份层,对照 2026 年 9 月 15 日的现役层,近五个月两层名册逐件对读。全部证据来自目录结构,可复核。核心发现三条:装机层只进不出——抽查的四月层老件无一失踪,找不到卸载痕迹;成分剧变——四月层清一色工程功能件、零人名门牌,九月层人名件已过半;版本管理工具在场、习惯缺席——技能目录本身是个 git 工作副本,但安全网靠的仍是一次手动整目录拷贝。评测表对四月层服役至今的八件老件做结构回访。

数据面板:两层名册对读

先把两层账本摊开(口径:目录名册核对,含插件命名空间注册;人名件占比沿用本刊今日普查口径):

项目 四月层(20260417 备份) 九月层(0915 现役)
门牌总数 近 50 件 三百二十余件
成分 清一色英文功能件:电信栈、部署、安全、笔记、浏览器自动化 人名件约 180 块,占比过半
人名门牌 名册内未发现 沉积为主体
供给通道 单一 git 主仓 git 主仓 + 三个插件市场(claude-plugins-official、obsidian-skills、anthropic-agent-skills)+ 手动快照
备份 本体 无(最近一层还是四月)

三个插件市场合计为现役层贡献了二十多块带命名空间的门牌:example-skills: 下 16 件官方示例、obsidian: 下 4 件,另有 frontend-design:frontend-design 这类完整限定名注册。plugin-dev 插件随包自带 7 件元课程(agent-development、command-development、hook-development、mcp-integration、plugin-settings、plugin-structure、skill-development),hookify 带 writing-rules,stripe 带 stripe-best-practices——「件中件」是插件化分发后才有的新物种,四月层里没有。

两层数量差近二百七十件。关键在于:这个差值几乎全部由人名件、内容创作件、教学件贡献——四月层的工程件存量原地不动,增量换了物种。

评测对比表

对四月层服役至今、本期逐一回访的八件老件打分。口径说明:功能完整度与实战效果按结构证据与运行痕迹推断(未逐件实测),社区活跃度维以「结构工程度」(文件名册可核)替换,上手难度星越多越容易。未做在线核验。

老件 功能完整度 设计质量 实战效果 上手难度 结构工程度
defuddle ★★★ ★★★ ★★ ★★★★★ ★
agent-browser ★★★ ★★★★ ★★★ ★★★★ ★
planning-with-files ★★★★ ★★★★ ★★★ ★★★★ ★★
long-running-agent ★★★★ ★★★★★ ★★★ ★★★ ★★★
sentry ★★★ ★★★★ ★★★ ★★★ ★★★★
notion-knowledge-capture ★★★★★ ★★★★★ ★★★★ ★★★ ★★★★★
pcap-analyzer ★★★★ ★★★★ ★★★★★ ★★ ★★★★★
cloudflare-deploy ★★★★ ★★★ ★★ ★★ ★★★★★

八件老件逐一回访

一、defuddle:单文件件的标本

整件只有一个 SKILL.md,零脚本、零参考、零模板。这类件的全部能力就是一段写好的提示词——指挥宿主里已有的工具完成任务,自己不带一颗子弹。亮点是维护成本趋近于零:没有脚本就没有运行环境问题,没有参考文档就没有过期问题。短板同样极致:能力上限等于宿主已有工具的上限,提示词写得再好也只是调度员。单文件件是装机层里最容易被「装完就忘」的物种——它不报错、不占用、也不产出存在感。适合当新手认识 Skill 结构的第一课:原来一个 SKILL.md 就是一件。

二、agent-browser:单文件开车的浏览器件

结构上与 defuddle 同档:一个 SKILL.md 走天下。但定位激进得多——浏览器自动化这种重活,它也选择不带任何脚本,纯靠提示词调度。结合现役名册看更有意思:同一台机器上还住着 chrome-automation 和 playwright 两个浏览器件,三个件同住一层,分工全凭各自 description 的措辞边界。这正是此前「描述里互相让路」话题的活体样本——不过程度更重:三个同域件挤在同一个触发池里,用户一句「帮我打开网页操作一下」,裁决权完全交给描述文字的细微差异。零依赖是它的卖点,触发模糊是它的账单。

三、planning-with-files:把计划落盘的方法论件

一件 SKILL.md 加 examples.md、reference.md 两个随行文档,三文件结构,纯文档无脚本。定位是长任务的后悔药:把计划、进度、上下文写进文件,让任务跨会话可续——模型每跑一步都有盘可查,而不是全靠会话记忆硬扛。亮点是方法论普适,不绑定任何语言和框架,装机五个月零维护。短板是纪律靠自觉:它约束的是「应该落盘」,模型哪一步偷懒不写,它没有强制手段。方法论件的通病——好老师,没有教鞭。

四、long-running-agent:模板即接口的资产件

结构升一档:SKILL.md 之外,references 里躺着 initializer-prompt 和 coding-prompt 两段提示词,assets 里放着 feature_list_template.json 和 progress_template.md 两张模板。设计意图从文件名就能读出:把长任务初始化和执行拆成两段可复用提示词,任务拆成特性清单、进度落成模板文档——典型的「主件薄、弹药外挂」资产件写法。亮点是模板即接口:用户照着 JSON 模板填清单,产出物结构稳定可验收。短板是同步无机制:主件改版时,两段提示词、两张模板各自为政,没有版本锚点,半年下来是否还匹配主件逻辑,只能拆开正文对质。

五、sentry:多宿主包装的活化石

五件套结构:SKILL.md、LICENSE.txt、agents/openai.yaml、scripts/sentry_api.py、assets 两张品牌图。这个布局和备份层里 .curated 目录下的件完全同款——布局指纹说明这批工程件出自同一个多宿主上游仓。最有意思的是那份 openai.yaml:上游为每个件预置了面向其他宿主的登记文件,装进 Claude Code 后它就是随包死重——不走心看根本发现不了自己带着另一个宿主的户口。这是多宿主分发的代价面:包装统一了, residue 也统一了。亮点是有真脚本(sentry_api.py),监控数据是真拉得动的;设计上属于「结构比功能值钱」的观察标本。

六、notion-knowledge-capture:唯一带测试的件

全场结构工程度最高:十八个文件。SKILL.md 之外,7 份 reference 写透了 faq、决策记录、学习笔记、操作指南、团队 wiki、文档六类数据库的建表逻辑与最佳实践,3 份 examples 给了三种入库样本,还有一个整个装机层罕见的目录——evaluations:两份 JSON 测试用例加一份 README。是的,这个件带回归测试。改了提示词,跑一遍 evaluations 就知道入库行为有没有退化,这是软件工程的做法,不是提示词工程的惯例。亮点:产出可对表核验,examples 降低了触发后的自由发挥空间。短板:十八文件的体量,逼着主件必须克制引用——渐进式加载是它的生命线,主文件若贪多,每次触发都是上下文税。

七、pcap-analyzer:唯一留下运行痕迹的件

全工程档:SKILL.md、TODO.md,references 里 tshark 命令手册与 5G 协议速查两份文档,scripts 里 analyzer.py、analyzer_5g.py、registration_analyzer.py 三段 Python。但它最值钱的不是结构,是那处别人都没有的东西:scripts/pycache/ 下的 analyzer_5g.cpython-313.pyc。字节码缓存只有真实运行过才会生成——装机三百件的结构抽查里,这是唯一带运行物证的件。「装机量不等于使用量」人人会说,这一小份 pycache 是第一个能摆上桌的证据。短板也有两处:TODO.md 在场说明件本身未完工;缓存没清理就进了装机层,说明打包搬运时少了道清扫工序。

八、cloudflare-deploy:文档镜像的重资产件

备份层与现役层同时在册的重资产件。references 下按产品域切片:ai-gateway、d1、ddos、durable-objects、browser-rendering、analytics-engine、api-shield……仅目录截取可见的就近二十个子域,每个子域再配 README、api、gotchas、configuration、patterns 五件套——把一家厂商的开发者文档整库搬进了件里。亮点:离线可查,gotchas 目录是踩坑精选,比官方文档的「一切正常」叙事诚实。短板是文档镜像件的宿命:上游文档天天动,镜像没有过期机制,装的那天就是过期倒计时的起点。重资产件的维护税,这是最重的一单。

资产密度三档

八件回访摆在一起,装机层的物种分化一目了然:

flowchart TD
    A["资产密度三档"] --> B["单文件档"]
    A --> C["提示词加模板档"]
    A --> D["全工程档"]
    B --> B1["defuddle"]
    B --> B2["agent-browser"]
    C --> C1["planning-with-files"]
    C --> C2["long-running-agent"]
    D --> D1["notion-knowledge-capture"]
    D --> D2["pcap-analyzer"]

装机榜单把三个物种当同一物种计数:defuddle 一件等于 1 个文件,notion-knowledge-capture 一件等于 18 个文件,cloudflare-deploy 一件上百文件。「装了三百件」的真实含义,在 1 到 300+ 文件之间摆动——这是装机量统计的第二处失真。第一处是上期拆过的「一件多牌」马甲灌水,那处是名义重复,这处是量纲错位,两处叠加,「装机数」这个指标的可信度要打对折。

地层剖面:三个发现的证据链

flowchart TD
    A["装机层地层剖面"] --> B["四月层:备份层"]
    A --> C["九月层:现役层"]
    B --> B1["近五十件功能件"]
    B --> B2["零人名门牌"]
    B --> B3["双层路径化石"]
    C --> C1["三百二十余件"]
    C --> C2["人名件过半"]
    C --> C3["三市场通道"]
    B1 --> D["抽查八件全部在册"]
    C1 --> D
    D --> E["名册层面零卸载"]

发现一:单向阀门。 抽查的八件四月层老件全部在现役名册在册,逐段比对备份名册未见门牌失踪。市场端有下架、有改名、有新星滚出榜单(本刊追踪过多起),装机端找不到对应的清理动作——没有卸载记录,只有增量沉积。后果是复利的:触发检索池只增不减,description 相近的件互相稀释,马甲家族的触发税随时间自动加息。不清理,膨胀不是风险,是必然。

发现二:成分漂移。 四月层清一色工程功能件——电信栈、部署、安全、笔记、浏览器自动化,-skill 后缀的人名门牌一件未见;九月层三百二十余件,人名件约 180。半年增量几乎全部来自人名、内容、教学线。市场端「内容件扎堆上架」的风向(此前多期观察到)隔了几个月才在装机端形成可读地层——装机层是生态的沉积岩,供给迁移在这里留的是滞后剖面。

发现三:工具在场,习惯缺席。 顶层技能目录本身就是一个 git 工作副本——.git 目录与远端指针俱在,增量、回滚、溯源的工具就躺在装机层里。但跨五个月的安全网,实际是一次手动整目录拷贝:备份目录名里带着日期,里面还封着 skills/skills/.curated 的双层路径化石——当时把一个整仓 checkout 连同内部目录一起拷了进去。git 能给的增量与精确回滚没上岗,手动快照只留下了「当时全貌」。人名件那边倒是留了流水线痕迹:libai-skill 的 references 里躺着一份 nuwa-phase1 研究综合文档——批产人名件的生成语料,和工程件的手动快照住在同一层,两种生产方式的代差一眼可见。

安装与自查命令

# 核对某件是否已在册
ls ~/.claude/skills/ | grep -i planning

# 市场端检索上游(生态通用检索入口)
npx skills find notion-knowledge-capture

# 通用补装方式:含 SKILL.md 的目录放入技能目录
git clone <仓库地址> ~/.claude/skills/<技能名>

# 本期同款地层快照法:给现役层留一层带日期的备份
cp -r ~/.claude/skills ~/.claude/skills_backup_$(date +%Y%m%d)

# 装完复查资产密度(文件数排行,重资产件一目了然)
find ~/.claude/skills -maxdepth 2 -type f | cut -d/ -f5 | uniq -c | sort -rn | head

推荐排行榜

最值得抄的三种结构

排名 老件 抄什么
1 notion-knowledge-capture evaluations 目录——给件配回归测试的完整示范
2 long-running-agent 模板即接口——assets 里放 JSON/MD 模板稳住产出结构
3 sentry 多宿主布局全貌——顺带看清 openai.yaml 这类包装死重

最值得装的三件四月层老件

排名 老件 理由
1 planning-with-files 零依赖、普适、五个月零维护
2 pcap-analyzer 电信运维域刚需,且是唯一有运行物证验证的件
3 notion-knowledge-capture 六类数据库建表参考直接可用

两个避坑

  1. 文档镜像件装前想清楚(cloudflare-deploy 型)——重资产无过期机制,装机那天开始贬值;
  2. 同域单文件件别全家桶(agent-browser / playwright / chrome-automation 三件同住)——触发池拥挤,描述措辞裁决一切,装两件以上先做一次触发分工自查。

趋势与结论

  1. 装机层需要自己的「卸载动作」。市场端有下架机制,装机端没有对应习惯,五个月零卸载的地层就是证据。每次装新件顺手做一次同域冲突检查,是当前唯一现实的做法。
  2. 内容件洪峰已经沉积进装机层。人名件从零到过半用了不到五个月,供给重心迁移在装机端完成落位;下一层地层大概率由「件中件」(插件随包元课程)和 evaluations 型工程化件贡献。
  3. 运行痕迹比装机数字诚实。三百件里只找到一处 pycache。评测装机规模时,「留过运行痕迹的件数」比「在册件数」更接近真相——建议每次季底清点时把这两数并排看。
  4. 快照要带日期,git 要真上岗。四月层那份备份之所以本期还能当地层用,全靠目录名里那个日期。反过来,git 副本在场却闲置,是装机层最大的浪费——一条 git log 就能回答「这半年装了什么、删了什么」,胜过任何手动名册比对。

参考来源

口径说明:本期为离线结构分析,全部证据取自一台真实机器的装机层目录名册(四月备份层与九月现役层),未做在线核验;文中对件功能的推断均基于结构证据与命名惯例。以下为栏目常规信息源,列作延伸入口。

  1. anthropics/skills — 官方示例仓,现役层 example-skills: 命名空间 16 件的上游
  2. skillsmp.com — 2300+ Skills 的可搜索聚合目录,可核对文中老件的市场在架状态
  3. mcpservers.org/agent-skills — Claude Skills 与 Agent Skills Library,官方与社区精选收录
  4. www.skillsdirectory.com — 带安全扫描评级的 Skills 目录,装机前核验入口
  5. skills.sh — Skills 生态站,热门榜单可与本期装机层地层做供需对照

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