<!-- title: Skill防腐学：版本与腐烂 -->

# Skill 防腐学：版本四派、腐烂三灶与回流两法——发布只是技能的第一天

## 概述

本期是 Skills 生态拆解第 8 轮。盘点存档后发现，设计模式这个方向的白地上只剩一块：**时间维度**。写法层（八种写法）管第一句怎么写，流程层（从拆到造）管第一天怎么走，体重学（W0–W6）管开工前选多重，撞名九组管装进拥挤机器后怎么和邻居相处——但没有任何一篇回答：**发布之后的第二个月，你的 Skill 靠什么不烂掉**。本期把本机注册表快照当活体标本库，清点出装机端现存的**版本策略四派**（git 原生、替换式后缀、共存式后缀、收藏式无版本），归纳**腐烂三灶**（事实过期、链条站烂、冷数据占热预算），再给出**回流两法**（训练式回写与自带复盘环节）。核心发现一句话：生态里最成熟的版本实践（baoyu-translate 迭代至 v1.59.0）和最幼稚的版本实践（约 245 件人设件零版本号）同时活在同一台机器上——版本策略的贫富差距，比功能质量的贫富差距更悬殊。材料边界照例如实声明：本轮 WebSearch 与外部抓取通道未获放行（发起即被环境权限拒绝），全部事实来自本会话注册表快照与本栏目 08-28 至 09-05 已逐行核验的存档，注册表对多数技能只展示名字不展示正文，凡属推断逐一标注※。

## 一、为什么防腐是没人写的章节：八期拼图缺的时间轴

先把已有资产摆一遍，确认这块白地是真的。体重学回答「造多重」，它的结论停在发布前一刻；撞名九组回答「邻居是谁」，但它把装机环境当成一张静态照片；上下文经济学回答「持有多贵」，账单按当前状态开。三篇共享一个隐含假设：**技能的形态在发布那天定型，之后不再变化**。

装机端的证据说这不是假设，是错觉。同一张注册表里，baoyu-translate 的 SKILL.md 已经迭代到 v1.59.0（08-29 期实抓口径）——一个 Skill 改了五十九版；而人设件集群约 245 件，**没有一件有版本号**（09-04 普查存档原话：「工具按迭代逻辑进化，人设按收藏逻辑增殖」）。ericsson-ppt-writer 一个名字挂了三份注册（裸名、-sc、-v2），course-video-maker 一个名字挂了四份（裸名、-link、-zh、-zh-link）。这些不是孤例，是装机端随处可见的时间地层：**有人把技能当软件养，有人把技能当照片存，有人把技能当兄弟生**。三种态度对应三种命运，而市场端（skills.sh 只给安装量、目录站只给安全扫描）没有任何一个界面显示「上次更新时间」——用户在安装时对新鲜度完全失明。这正是本文要补的账本。

## 二、版本策略四派：装机端的活体标本

| 派别 | 在册标本 | 注册表证据 | 版本住在哪 | 一句话腐烂面 |
|---|---|---|---|---|
| git 原生派 | baoyu-translate | 单件注册，无任何后缀 | 正文版本行 v1.59.0 + git 历史 | 永远只有一份真相，但历史对用户不可见 |
| 替换式后缀 | continuous-learning-v2 | v2 在册，裸名 v1 不存在※ | 名字本身 | 旧版用户拿不到迁移指引※ |
| 共存式后缀 | ericsson-ppt-writer / -sc / -v2 | 三份注册并列 | 名字三兄弟 | 三份描述互抢触发，真相变成三份 |
| 组合式后缀 | course-video-maker ×{-link, -zh} | 2×2 矩阵，四份注册 | 名字笛卡尔积 | 每加一个维度，维护面乘一次 |
| 收藏式（无版本） | 人设件约 245 件 | 零版本号 | 无 | 不腐烂——因为从不迭代，但也从不进化 |

逐派说清证据与代价。

**git 原生派：版本号住进正文，历史交给 git。** baoyu-translate 是本栏目逐段实拆过的件（08-29 期），SKILL.md 文件头带着版本号，迭代至 v1.59.0，文件体积 15,844 字节。它的版本策略是最经典的软件做法：单一文件就地进化，改动记录由 git 承载，用户装的永远是唯一真相。代价是**版本对路由层不可见**——描述层常驻的约 100 词里没有历史，用户无法从装机清单看出这是一件高频迭代的活件还是一件停更半年的死件。git 原生派适合单人或小团队作者：纪律成本最低，真相只有一份。

**替换式后缀：v2 上位，v1 消失。** 注册表里有 continuous-learning-v2，没有裸名的 continuous-learning——按注册表口径，旧名要么从未公开存在、要么已被移除（两者无法区分※，但名字本身宣告了作者的迭代意图：这件技能把自己设计成会被替换的）。替换式的优点是注册表干净，一个赛道一个名字；缺点是**断裂式升级**——装着 v1 的旧用户在 v2 上位后拿不到任何迁移指引，除非作者另写文档。生态里还没有人给「升级说明」立过规矩，这是替换式后缀悬而未决的债。

**共存式后缀：变体当兄弟养。** ericsson-ppt-writer 三份注册并列是装机端最直观的地层剖面：-sc 疑为简体中文变体、-v2 疑为第二代（后缀语义未获正文验证，系命名惯例推断※）。共存式和替换式的分野一目了然：**替换式是换人，共存式是生娃**。它的代价在撞名九组里已经量化过——同一赛道的多份带描述注册会互相抢触发，且每份描述都是一份 100% 常驻的上下文租约。三兄弟共存的 ericsson 系，等于用户为同一个 PPT 赛道付了三份描述租金，每次「做个 PPT」都是三选一路由。

**组合式后缀：笛卡尔积的维护面。** course-video-maker 家族是最极端的标本：裸名、-link、-zh、-zh-link 四份注册，正好是「语言 × 是否带链接」两个维度的 2×2 组合。组合式后缀的数学很残酷：**每引入一个二值维度，件数翻倍、描述租金翻倍、维护面翻倍**。体重学给全家桶算过维护税，组合式后缀是变体版的同一种税——而且它通常不是设计出来的，是长出来的：先有中文版，再有带链接版，然后有人要「中文带链接版」，第四件就这样自然分娩。没有一件是错的，加起来就是一座需要同时供养的公寓楼。

**收藏式：合法的静止。** 人设件集群 245 件零版本号，普查存档已经给过定性：它们按收藏逻辑增殖，新增一个角色、绝不覆盖旧角色。放在版本学的框架下重看，收藏式其实是**对时间免疫的策略**——人设不过期、不被竞品迭代淘汰，前提是你接受普查存档钉死的代价：近乎零载荷的描述意味着「自愿退出模型触发」，召唤权完全交还给用户的手。收藏式不是错误，是把进化权兑换成了零维护成本的一种清醒交易。

```mermaid
mindmap
  root((版本策略四派一式))
    git原生派
      baoyu-translate v1.59.0
      单一真相 历史在git
      版本对路由层不可见
    替换式后缀
      continuous-learning-v2
      v1消失 干净但断裂
      迁移指引无人立规
    共存式后缀
      ericsson三兄弟
      三份描述互抢触发
      三份常驻租金
    组合式后缀
      course-video-maker 2x2
      每加一维 维护面翻倍
      公寓楼不是设计出来的
    收藏式无版本
      人设件约245件
      对时间免疫
      代价是永不触发
    生命周期拆件 附
      openstoryline-install / -use
      装与用分开成两件
```

附一个边角发现：注册表里 openstoryline-install 与 openstoryline-use 并列——这不是版本策略，是**生命周期策略**：把「安装」和「使用」拆成两件技能，各管一段。另有 pptx-test 疑为把验证环节独立成件的尝试※。拆件维度可以按版本、按语言、按功能，也可以按生命周期——但每拆一件都要付一份描述租金，这笔账撞名九组已经算过，不重复。

## 三、腐烂三灶：技能从什么时候开始烂

版本策略决定腐烂之后怎么补救，腐烂本身从哪来？存档里能拼出三个火源，对应三种完全不同的抗腐设计。

**灶一：事实过期。** 任何引用了外部事实的技能都在和现实赛跑——API 换版、文档改版、依赖升版。官方 mcp-builder（09-03 期逐段拆解）给出了全生态最漂亮的抗腐设计：它不内嵌 MCP 规范内容，而是写了一段**获取最新文档的确定性指令**——先抓 `modelcontextprotocol.io/sitemap.xml` 定位页面，再给 URL 加 `.md` 后缀拿 Markdown 原文；SDK 的 README 也要求现场从 raw.githubusercontent.com 拉 main 分支。拆解存档那句评语值得原样引用：「技能文档最怕写死版本号然后腐烂，这个设计直接绕开了腐烂问题」。**把会过期的内容，替换成获取最新内容的指令**——这是灶一的灭火器，任何引用外部规范的技能都该抄。

**灶二：链条站烂。** 体重学给 W6 家族流水线记的死法是「一站断、全链停」，并留下一句「W6 的真实门槛不在写，在养」。superpowers（09-04 快照口径 281,342 星）的十几个技能互相接线，出口即入口、状态落盘——这套架构的燃料是**每一站的指南都保持新鲜**；链条上任何一个站的 SKILL.md 停止维护，贬值会沿着接线传染到全链。家族件的防腐不是逐件维护，是**链条测试**：定期让整条产线空跑一遍，断在哪一站修哪一站。单件技能腐烂只损失自己，家族件腐烂损失的是整条产线的信用。

**灶三：冷数据占热预算。** headcount（快照轨迹 783→1,185 星，09-03 期存档）的教训最具体：125+ 技能的长尾岗位 SKILL.md 停留在初版，「冷数据占据了热预算」——不更新的旧件不只是没用，还在常驻描述层继续收租、继续和活跃件抢触发。这是腐烂的会计学形态：**技能的维护成本不只是作者的修改时间，还有每一件陈货对全体邻居的路由干扰**。装机越多，腐烂的负外部性越大。

```mermaid
flowchart TD
    P["发布日:选定版本派别"] --> U["被路由命中·开始使用"]
    U --> T{"时间流逝"}
    T -->|"外部事实漂移"| D1["灶一:事实过期<br/>灭火器:抓取指令替代写死内容"]
    T -->|"家族链条某站停更"| D2["灶二:链条站烂<br/>灭火器:定期整链空跑"]
    T -->|"长尾无人维护"| D3["灶三:冷数据占热预算<br/>灭火器:下沉或下架"]
    D1 --> F["修订事实层 版本+1"]
    D2 --> F
    D3 --> X["下架/合并 召回租金"]
    F --> P
    U -->|"失败案例沉淀"| B["教训回写环节"]
    B -->|"规则收敛"| P
```

## 四、回流两法：让教训自己走回技能里

防腐的最高形态不是挡住腐烂，而是**把使用中的失败变成版本号前进的燃料**。生态里已经出现两条回流路线。

**训练式回写：backpass。** 09-03 周报收录的新星（⭐697，快照口径），标语是那句著名的隐喻："You don't write AGENTS.md. You train it with gradient descent."——AGENTS.md 不是写出来的，是像参数一样被「训练」出来的。当然没有真的反向传播：实际机制（据该期周报的描述级分析）是把说明文件当可迭代参数，让 Agent 干活、收集失败案例、把教训回传进文本，循环到规则收敛。它把回流对象从单个 Skill 升级到整个 harness 的说明书，方向感极强；风险也已被同期周报指出——文本层面的「梯度下降」没有 loss function，哪条教训值得写入、哪条旧规则该删，全靠人工仲裁，仲裁失职的说明书会被矛盾规则撑爆。

两条路线对普通作者的落点是同一条施工条款：**在你的 SKILL.md 末尾留一节「教训回写」格式**——失败输入、错误输出、修订后的规则三行一段，攒够 N 条就发一版。没有这一节，教训散落在用户的会话里腐烂；有这一节，每个失败案例都是下一次迭代的原料。goldie 的增长曲线（935→1,082→1,598，三期快照）从反面佐证过同一件事：能沉淀、可验证的东西才有复利。

## 五、评测对比表

样本八件，三件沿用存档原始加权分（括号注明出处），四件为注册表描述级估分（标注※，权重为本栏固定口径 25/25/20/15/15，上手分越高越容易），backpass 按 09-03 周报星级折算。

| 样本 | 版本派别 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% | 加权 |
|---|---|:---:|:---:|:---:|:---:|:---:|:---:|
| baoyu-translate | git 原生 v1.59.0 | ★★★★★ | ★★★★★ | ★★★★ | ★★★★ | ★★★★ | **4.50**（08-29 存档） |
| superpowers | 家族+链条养护 | ★★★★★ | ★★★★★ | ★★★★☆ | ★★★★★ | ★★★★★ | **4.7**（09-05 体重学存档） |
| backpass | 训练式回写 | ★★★ | ★★★★★ | ★★★ | ★★★ | ★★★★ | **3.65**（09-03 周报折算） |
| headcount | 长尾腐烂反面教材 | ★★★★ | ★★★★☆ | ★★★ | ★★★ | ★★★★☆ | **3.80**（09-03 存档） |
| ericsson-ppt-writer 三件※ | 共存式后缀 | ★★★ | ★★★ | ★★★ | ★★★★ | ★★ | **3.00**（估） |
| continuous-learning-v2※ | 替换式+回流意图 | ★★★ | ★★★★ | ★★ | ★★★★ | ★★ | **3.05**（估） |
| course-video-maker 四件※ | 组合式后缀 | ★★★ | ★★★☆ | ★★★ | ★★★★ | ★★ | **2.88**（估） |
| 人设件集群（整体） | 收藏式无版本 | ★★ | ★★ | ★★★ | ★★★★★ | — | **2.4**（09-04 普查存档） |

这张表的读法和体重学那张正好相反：体重学里加权分与形态几乎无关，而这里**加权分与版本纪律的排名基本同向**——前四名全是「把时间当回事」的件，后四名全是「让时间停摆」的件。样本量太小不足为证，但方向与既有事实吻合：baoyu-translate 用五十九次迭代磨出了 13,351 星（08-29 GitHub 口径），而人设件的 2.4 分里本来就写着「无验收机制」。**迭代是设计质量的一部分，不是设计之外的努力。**

## 六、给作者的四条防腐施工条款

**条款一：发布那天就选好派别，默认 git 原生。** 后缀只该在语义真正分叉时使用——变体是给「同时需要两种行为」的用户准备的，不是给「改进了一版」的自己准备的。改进走 git，分叉才开后缀；判断标准一句话：新版要不要和旧版**同时存在**在用户机器上？不要就替换，不要就别开后缀。

**条款二：把易腐内容写成获取指令。** 抄 mcp-builder：凡是引用外部规范、文档、SDK 的段落，问自己「这段六个月后还成立吗」——不成立的，改写成带 sitemap 定位和 `.md` 后缀的抓取指令。技能里最抗腐的不是事实，是**获取事实的方法**。

**条款三：给 SKILL.md 留一节教训回写格式。** 三行一段：失败输入、错误输出、修订后规则。配合条款一的 git 原生派别，攒够一批就发版。这一节就是你的技能和 backpass 方法论的接口——没有 loss function，就人工仲裁，但仲裁要有地方落笔。

**条款四：家族件配链条测试，长尾件定期清扫。** 十件以上互相接线的家族，每月空跑一遍整链；超过二十件的单体库，检查冷数据——半年没命中还占着描述租金的，下沉、合并或下架。防腐的本质是回收：**腐烂不是技能变旧，是旧技能继续占着新技能的预算。**

## 安装与使用

```bash
# baoyu-translate（git 原生版本派参考实现，v1.59.0 在 SKILL.md 文件头）
npx skills add JimLiu/baoyu-skills

# backpass（训练式回写方法论，AGENTS.md 迭代器）
npx skills add kunchenguid/backpass

# superpowers（家族流水线，防腐靠链条测试与状态落盘）
npx skills add obra/superpowers

# headcount（长尾腐烂的活体反面教材，装前先读 README 确认形态）
npx skills add cbrock84/headcount
```

## 推荐排行榜

- **版本纪律最强**：baoyu-translate（4.50）——五十九次迭代的 git 原生派标本，唯一真相 + 正文版本行，单人作者的标准答案。
- **抗腐设计最巧**：官方 mcp-builder——「抓取指令替代写死内容」一句话值回整篇拆解，所有引用外部规范的技能都该抄。
- **回流机制最大胆**：backpass（3.65）——把说明书当可训练参数，方向领先生态半个身位，风险在人工仲裁没有护栏。
- **家族养护范本**：superpowers（4.7）——28 万星体量下靠出口即入口与状态落盘维持全链新鲜，「养」字诀的活教材。
- **最值得警惕**：headcount（3.80）——125 件编制的长尾停更，冷数据占热预算的现场教学；上规模之前先想清楚清扫机制。
- **合法的静止奖**：人设件集群（2.4）——零版本零维护零触发，用进化权换来了对时间的免疫；选它之前想清楚你要的是工具还是收藏。

## 结语：星数是照片，版本是长曝光

八期拼图补上最后一块后，这个系列对 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 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
