<!-- title: Skill的上下文经济学横评 -->

# 上下文是新的内存：六件 Skill 的预算管理术——从 12,500 词的员工名册到有界的 JSON 切片

## 概述

本期是本系列第 4 轮，模板方向是内容创作与办公。但盘点存档后发现，这个方向近三天已被本栏目连拆五篇（办公头牌横评、编排对决、变现半场、把书变成课、质检层），五格填充度接近饱和。按去重纪律，本期换一个此前从未被当作主线的**底层技术领域：上下文预算**——Skill 生态的「内存管理」。上午的质检层文章在结尾留了一句「53 件的上下文账」式闲笔，08-29 的 headcount 拆解算过一笔 12,500 词的名册账，writing-great-skills 拆解引过一段成本核算——这些散落在各期的碎片拼起来，恰好是一个完整且无人认领的赛道。本期六件样本全部来自本栏目 08-29 至 09-04 已逐行核验的存档与本机装机实测，**零新增抓取，样本即来源**；星数为各期快照口径。核心发现：生态已自发演化出四条预算路线（编译裁剪、分块注入、有界输出、按需加载）加两条会计制度（禁用自动触发、依赖声明），而「上下文成本标签」至今无人提供——这是这条赛道最大的空位。

## 一、为什么是上下文预算：星数之外的账本

先立一个本系列反复验证过的公理：按官方 skill-creator 的加载模型，**描述层约 100 词、常驻上下文，是模型决定是否触发的唯一依据；正文与资源按需加载**。这句话的经济学含义是：每装一件 Skill，等于签了一份「每轮对话都付费」的永久租约——你买的不是功能，是一块常驻内存。

而市场的定价机制完全看不见这笔账：榜单只显示星数和安装量，没有任何一个目录给 Skill 标注「常驻多少词、命中后加载多少、跑完一轮产出多少 token」。星数是社交证明，上下文账本才是使用成本——两者之间的汇率，就是本期的主题。

## 二、评测对比表

六件样本中四件的加权分直接沿用各期存档（括号注明期数），security-ownership-map 与 triage 的折算口径见表下注。

| 样本 | 预算路线 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% | 加权 |
|---|---|---|---|---|---|---|---|
| baoyu-translate | 分块注入 | ★★★★★ | ★★★★★ | ★★★★ | ★★★★ | ★★★★ | **4.50**（08-29 存档） |
| pptx（官方） | 按需加载 | ★★★★ | ★★★★★ | ★★★★☆ | ★★★★ | ★★★★★ | **4.50**（09-03 存档） |
| triage（mattpocock） | 依赖声明+原语复用 | — | — | — | — | — | **4.25**（08-29 存档实测） |
| headcount | 编译裁剪/两级触发 | ★★★★ | ★★★★☆ | ★★★ | ★★★ | ★★★★☆ | **3.80**（09-03 存档） |
| security-ownership-map | 有界输出 | ★★★★ | ★★★★ | ★★★☆ | ★★★☆ | ★★★* | **3.60**（本期折算） |
| writing-great-skills | 会计制度 | ★★★ | ★★★★★ | ★★★★ | ★★★ | ★★★★★ | **4.00**（08-29 存档） |

> 折算说明：security-ownership-map 的社区格在 09-04 期按「分发方式」记录（本地出厂件、需 pip 依赖），本期折算时按三星计入；triage 沿用 08-29 期逐段拆解的实测分，不再拆维度。权重为本系列固定口径（功能/设计/实战/上手/社区 = 25/25/20/15/15）。

## 三、主拆四件：四条预算路线

### 路线一：编译裁剪——headcount 的两级触发

headcount（cbrock84/headcount，快照轨迹 783→892→1113→1,185 星）的困境与解法是这套经济学最极端的样本。125+ 技能不可能平铺——于是它插入了**一层部门路由中间件**：根描述常驻的只有 15+ 部门的名字与一句话职能，命中部门后才加载该部门的岗位 SKILL.md。第一级触发花小钱买目录，第二级触发才花大钱买说明书（结构为按描述与官方加载模型的推演，正文未逐行核验，存档已标注）。

这条路线有个哲学级的对照：find-skills（09-01 存档口径安装量 3.2M、总榜第一）走的是「用检索换内存」——要什么现查市场，本地只留一个指针；headcount 走的是「用组织换检索」——125 人编制一次装进仓库，换本地确定性。两条路线赌注完全相反，但账本是同一本：常驻层必须薄。headcount 的三个真实短板（触发串扰、技能腐烂、安装形态不明）里有两个就是预算问题：125 份描述的近邻密度会互相抢触发，而长尾岗位的 SKILL.md 停留在初版，等于**冷数据占据了热预算**。

### 路线二：分块注入——baoyu-translate 的长文手术

当问题从「装太多」反转成「吃不下」，路线就换成了分块。baoyu-translate（JimLiu/baoyu-skills，08-29 GitHub 口径 13,351 星，SKILL.md 迭代至 v1.59.0）处理超 4,000 词长文的方案，是整条赛道工程含量最高的设计：先全局扫描抽取术语建立 session glossary；用 scripts/chunk.ts 按 **Markdown 块边界**分块（不在段落中间切断）；主 agent 生成共享上下文文件 02-prompt.md（术语表+风格+背景）；每个块派一个 subagent 并行翻译，**每个 subagent 都带着同一份 02-prompt.md**。原文写得很直白："Consistency is guaranteed by the shared 02-prompt.md"。

它的深刻在于承认了一个交换：并行化牺牲了「后文参考前文」的天然一致性，于是用一份共享上下文文件把一致性**重新注入**——这是用显式内存管理换回隐式上下文被切碎的损失。配套的 01-analysis 到 05-revision 编号落盘，则把中间态从内存挪到了磁盘：每一步可回溯、可中断重跑，等于给长任务装上了虚拟内存的换页机制。代价同样明码标价：15,844 字节的 SKILL.md 每次触发都进上下文，作者显然押注「高频重度使用」——轻用户该走 quick 模式，这正是三模式分层的另一层预算含义。

### 路线三：有界输出——ownership-map 的切片纪律

前两条管「进来的」，第三条管「出去的」。security-ownership-map（本机出厂件，09-04 期逐行拆解）从 git 历史构建「人×文件」二部图加共变图，这种全量图数据放进上下文等于灾难。它的解法是 query_ownership.py：把结果切成 **"small, JSON-bounded slices"**，原文明说是为了 **"without loading the full graph into context"**——查某文件的共变邻居、查 bus factor ≤ 1 的加密文件、查 orphaned_sensitive_code，每条都是小 JSON。

这是 SKILL.md 设计里的一个范式级判断：**脚本不只是自动化工具，更是上下文预算管理器**。聚合在脚本里做完，模型只消费结论切片。它的工程素养同样体现在默认值里：共变图默认忽略 lockfile、`.github/*` 这类胶水文件，默认排除 Dependabot 和 merge commit——不是功能取舍，是**防止垃圾数据挤占切片预算**。大仓库要自己记得加 `--since`，则是把裁剪权显式交给用户。

### 路线四：按需加载——pptx 与 docx 的两极，加一条命名路由

官方四件套内部就藏着加载策略的两极。pptx 是标准渐进披露：主 SKILL.md 开篇一张 Quick Reference 表把三种任务路由出去，读用 markitdown、改模板走 editing.md、从零建走 pptxgenjs.md——主文件轻，命中后才拉子文档。docx 反其道而行：约 700 行全内联，从 DXA 单位表到修订 XML 细节一气呵成，换来「模型编辑时不需要二次跳转，所有规则同屏可见」。**渐进披露省的是常驻、付的是跳转延迟；全内联省的是跳转、付的是单次加载**——同一族任务里两种完全成立的预算策略，选择取决于任务里「查」和「改」谁占大头。

同一条路线还有一个更精巧的变体：security-best-practices 的 references 目录用 `<语言>-<框架>-<栈>-security.md` 的**命名路由**，让模型自己定位到唯一需要的那份文档，找不到就退化到模型自身知识。目录结构即索引，文件名即路由表——零运行时成本的按需加载。

## 四、会计制度两件：管预算的规则，不是花预算的手

**writing-great-skills**（mattpocock/skills，08-29 口径 320.8K 安装）贡献了这条赛道唯一一段显式的成本核算。它的 frontmatter 写着 `disable-model-invocation: true`——禁止模型自动触发，理由是算过账：model-invoked 的 description 每轮对话都占 context load；user-invoked 零上下文成本，但花 cognitive load——"你自己就是必须记住它存在的索引"。高频件该挂自动挡，低频件该收进抽屉，这个开关就是 Skill 的「内存驻留策略」。它还有两个省 token 的微观手法：no-op 判定法（这句话相对模型默认行为没改变什么？没改变就删）和 leading word（用模型预训练里已有的紧凑概念 `_tight_`、`_red_` 替代三处重复的长描述，"fewer tokens, and a sharper hook"）。

## 五、路线全景与三层账单

```mermaid
mindmap
  root((上下文预算四路线两制度))
    编译裁剪
      headcount 1185星<br/>两级触发 部门路由
      对照 find-skills<br/>用检索换内存
    分块注入
      baoyu-translate 4.50分<br/>块边界分片 session glossary
      共享02-prompt.md 再注入一致性
    有界输出
      security-ownership-map<br/>query脚本 JSON切片
      默认值防垃圾数据占预算
    按需加载
      pptx官方 QuickReference路由
      docx 全内联反路线
      security-best-practices 命名路由
    会计制度
      writing-great-skills 禁自动触发
      no-op判定与leading word
      triage 依赖声明 原语五出口
```

把六件样本放进一次触发的完整生命周期，上下文的三层账单就清晰了：

```mermaid
flowchart TD
    subgraph L1["常驻层：每轮都付费"]
        D1["描述层 ≈100词/件"] --> D2["router 或部门路由<br/>只留目录不留正文"]
    end
    subgraph L2["按需层：命中才付费"]
        S1["SKILL.md 正文"] --> S2["references 子文档<br/>命名路由定向加载"]
    end
    subgraph L3["切片层：大输入大输出各管一端"]
        C1["输入端：块边界分片<br/>+共享上下文文件"] --> C2["子代理并行"]
        O1["输出端：脚本聚合<br/>只回传有界JSON"]
    end
    L1 -->|"命中"| L2
    L2 -->|"数据量超限"| L3
```

## 六、可抄的五条预算规则

**规则一：先算常驻账，再堆功能。** 描述层是唯一的永久租约，件数×100 词就是你的起跑负担。写描述时每加一个形容词都是终身租金——出厂件那句话在本系列成立过一次，在预算语境下再成立一次：**描述不是广告，是按字计费的路由表**。

**规则二：冷数据下沉，热数据上浮。** 正文只保流程，规范细节外置到 references/；子文档用命名约定让模型自己路由（抄 security-best-practices 的 `<语言>-<框架>-<栈>` 格式）。判断标准：一段文字若只在「某类任务」时才有用，它就不配待在主文件里。

**规则三：大输入分块，且必须共享上下文。** 超 4,000 词的处理任务，块边界分片（Markdown 块、章节、函数）+ session glossary + 一份共享上下文文件注入每个子任务。跳过共享文件，一致性就会在第三块开始漂移——baoyu-translate 用 v1.59.0 的迭代次数验证过这条路。

**规则四：大输出切片，脚本当预算管理器。** 能在脚本里聚合的（统计、校验、排序）绝不把原始数据倒进上下文；给模型的永远是「结论+定位」的小 JSON。设计脚本时先问：这个输出喂给模型的是原料还是切片？

**规则五：给每件 Skill 定驻留策略。** 高频件开 model-invoked，低频件 `disable-model-invocation` 收进抽屉；套件超过五件就该做 router 收口或声明依赖关系。没有驻留策略的技能库，会在第 20 件之后把触发准确率和 token 账单一起拖垮。

## 七、安装与使用

```bash
# baoyu-translate（分块注入参考系，Skill 位于仓库 skills/ 子目录）
npx skills add JimLiu/baoyu-skills

# headcount（编译裁剪样本，装前先按 README 确认安装形态）
npx skills add cbrock84/headcount

# mattpocock 全家桶（writing-great-skills / triage / grilling，共 53 件）
npx skills add mattpocock/skills

# 官方 pptx（按需加载样本，随官方插件分发）
# Claude Code 内执行 /plugin，添加 marketplace anthropic-agent-skills，安装 example-skills

# security-ownership-map（有界输出样本，本机出厂件，依赖 networkx）
pip install networkx
python ~/.claude/skills/security-ownership-map/scripts/run_ownership_map.py \
  --repo . --out ownership-map-out --since "12 months ago"
python ~/.claude/skills/security-ownership-map/scripts/query_ownership.py \
  --data-dir ownership-map-out summary --section orphaned_sensitive_code
```

## 推荐排行榜

- **综合最强**：baoyu-translate（4.50）——分块、术语表、共享上下文、编号落盘，长上下文处理的完整参考实现。
- **设计最精**：writing-great-skills（4.00）——唯一把成本账写进正文的样本，disable-model-invocation 的会计思维领先生态一个身位。
- **最被低估**：security-ownership-map（3.60）——「脚本即预算管理器」的范式样本，任何要处理大图、大库、大日志的 Skill 都该抄它的切片纪律。
- **最适合套件作者**：triage + grilling（4.25）——依赖声明与原语复用，1,820 万安装量级验证过的去重路线。
- **最大胆也最危险**：headcount（3.80）——12,500 词的名册账逼出了两级触发，但触发串扰与技能腐烂两个隐患决定了它的上限。
- **架构启示奖**：官方四件套的内部两极——pptx 与 docx 证明渐进披露与全内联可以同仓共存，选型跟着任务走。

## 结语与空位

六件样本摆完，这条隐形的赛道有了第一张地图：**生态的竞争正在从「会做什么」下沉到「花多少内存去做」**。星数榜上的头部（superpowers 281,342、mattpocock 247,432）能在装机环境里共存，靠的不是功能堆叠，而是各自把预算纪律跑通了。而空位同样清楚：至今没有任何市场或目录给 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)
