# 装机层半年地层：只进不出的证据 ## 概述 本期是生态周报，先交代观测口径：外部榜单通道本期受限，新上架名单与星数变动无法给出，泛浏览也不做——与其报一个核不了的榜单，不如换一层数据。本期用「地层法」做周报：一台真实机器上，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 目录是踩坑精选，比官方文档的「一切正常」叙事诚实。短板是文档镜像件的宿命：上游文档天天动，镜像没有过期机制，装的那天就是过期倒计时的起点。重资产件的维护税，这是最重的一单。 ## 资产密度三档 八件回访摆在一起，装机层的物种分化一目了然： ```mermaid 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+ 文件之间摆动——这是装机量统计的第二处失真。第一处是上期拆过的「一件多牌」马甲灌水，那处是名义重复，这处是量纲错位，两处叠加，「装机数」这个指标的可信度要打对折。 ## 地层剖面：三个发现的证据链 ```mermaid 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 研究综合文档——批产人名件的生成语料，和工程件的手动快照住在同一层，两种生产方式的代差一眼可见。 ## 安装与自查命令 ```bash # 核对某件是否已在册 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](https://github.com/anthropics/skills) — 官方示例仓，现役层 `example-skills:` 命名空间 16 件的上游 2. [skillsmp.com](https://skillsmp.com) — 2300+ Skills 的可搜索聚合目录，可核对文中老件的市场在架状态 3. [mcpservers.org/agent-skills](https://mcpservers.org/agent-skills) — Claude Skills 与 Agent Skills Library，官方与社区精选收录 4. [www.skillsdirectory.com](https://www.skillsdirectory.com) — 带安全扫描评级的 Skills 目录，装机前核验入口 5. [skills.sh](https://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 等场景全覆盖。