用途:这是面向“库参考蒸馏”类技能的原型方法论,位于 /dev-skill:new 与 /dev-skill:ingest 之上。生成器负责结构外壳,本技能负责每个库都要重新做出的四类编辑决策:从哪里取材、如何针对版本漂移做固定、如何设计分类与规则、如何让元数据成为诚实的校验和。它是一套约束集,而非生成器。
适用场景:新建库参考蒸馏技能;针对上游新版本或大版本升级演进已有技能;审查“像文档改写”的草稿;为新技能选择分类与前缀;决定把上游版本固定在 SKILL.md 标题还是仅 metadata.json;怀疑规则相对上游已漂移时刷新技能。
四类规则:1)来源选择(source 前缀):source-priority-ladder 给出 Docs → 博客/变更日志 → GitHub 讨论 → 类型 → 示例的顺序,仅当库发布 llms.txt 时该阶梯反转;source-failure-gap 要求规则捕捉文档遗漏而生产暴露的内容,仅复述 API 的规则应删除。2)版本管理(pin):pin-by-velocity 指出稳定 API(Zod、RHF)版本只放 metadata.json,快速变化的 API(nuqs v2.5–v2.8、Tailwind v4)需在 SKILL.md 标题写明范围;pin-refresh-vs-head 要求演进时将技能与上游 HEAD 做差异比对,并沉淀漂移教训。3)规则形态(shape):shape-category-ladder 要求按 CRITICAL 设置 → HIGH 隔离/性能 → MEDIUM 组合/集成 → LOW 边缘情况/打磨的层级选取类目,不要自创形态;shape-when-to-apply-template 含四个槽位——导入语句触发、问题域语言、频率信号、指向兄弟技能的明确“不做什么”边界。4)元数据纪律(meta):meta-references-checksum 要求 metadata.references[] 恰好等于规则中引用的 URL 集合,不得多也不得少,否则规则或元数据必有一方不实。
限制:不适用于代码图集蒸馏(如 openai-codex-rust-patterns、opencode-ts、nextjs-ppr-patterns),其来源是固定 HEAD 的真实仓库而非上游文档;也不适用于方法论蒸馏(如 radical-simplification、deterministic-metric-design,来源是命名的人及其经典)、脚手架(如 expo-design-system-scaffolder,属组合工作流而非规则手册)。与 radical-simplification、skill-authoring、deterministic-metric-design 相关。规则由追溯 5 个已发布库参考技能的引用来源提取;覆盖度由 /dev-skill:eval 在真实库蒸馏提示上证明。