深度解析one-skill-to-rule-them-all的渐进式披露架构728行核心文件按需加载参考文件的设计哲学【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-allOne Skill to Rule Them Allone-skill-to-rule-them-all是一个会自动观察你 AI 工作会话、持续改进其他技能的元技能meta-skill。它最值得学习的设计是渐进式披露Progressive Disclosure架构728 行的核心文件负责每次触发时的行为而 4600 多行参考材料只在需要时按需加载。今天这篇指南带你拆解这套核心按需加载的设计哲学以及它如何把上下文成本压到最低。为什么需要渐进式披露技能文件越大上下文成本越高先理解问题AI 技能skill在被触发时会加载到上下文里。如果技能是每次会话都要用的那么它的每一行都是固定开销——文件写得越长每次触发浪费的 token 就越多。这个项目把整个理念写成了一条规则见 references/skill-authoring.md一个技能应该只包含能在执行时改变智能体行为的内容。每次会话都需要的规则留在技能主体偶发性材料放进按需加载的参考文件——渐进式披露。换句话说技能主体按每次触发都会用到吗来取舍长目录、配方、故障目录这类某一类场景才查的内容统统移到references/目录用到才读。三层加载模型常驻元数据、触发核心、延迟参考这套架构的加载被明确设计成三个层级来源references/skill-authoring.md层级内容加载时机成本属性第 1 层前置元数据frontmatter始终在上下文中常驻极小第 2 层核心文件 SKILL.md 正文技能触发时每次触发的税第 3 层references/ 参考文件某件事真正用到时才读按需可延迟关键判断标准是一句话内容只有每次技能触发时都会改变行为才配进第 2 层。第 2 层是每次调用的税第 3 层不是——这就是渐进式披露的本质。728 行核心文件里留下了什么打开核心文件 SKILL.md你会发现它恰好728 行而且这个数字不是巧合文件头部的元数据里声明了core_max_lines: 728见 SKILL.md——这是技能自己命名的尺寸上限后面细讲正文只保留三类东西心智模型、少量每次触发都改变行为的规则会话启动协议、观察记录规则、呈现协议等、以及一份指向参考文件的指针清单见 SKILL.md。指针清单的写法很讲究。每个指针都明确写出加载触发器例如references/weekly-review.md ——当评审触发或用户要求时加载references/skill-authoring.md ——在创建或编辑任何技能之前加载references/migration.md ——仅当会话启动协议检测到旧版日志时加载项目文档里有一句很直白的评价references/skill-authoring.md没有触发条件的文件名列表不是渐进式披露只是参考文献列表。一个没有触发器的指针读起来像可选的就会被跳过。7 个参考文件与触发器按需加载完整清单references/目录共 7 个文件、4620 行占了技能文本总量的 84% 以上——这些内容全部延迟加载。清单如下参考文件行数加载触发器摘自核心文件references/weekly-review.md1160评审触发或用户主动要求时references/skill-authoring.md1026创建或编辑任何技能之前references/observation-log.md954首次搭建日志、归档、id/元数据异常时references/environments.md717配置问题、压缩恢复后、无文件系统环境references/starter-principles.md388仅当初始原则集对账到期时references/migration.md203仅当检测到 3.0 之前的旧版单文件日志references/signals.md172不确定某事是否值得记录时可以看到触发器覆盖了三种典型场景常规流程评审、写作、异常诊断id 解析异常、扫描返回空、一次性操作旧版日志迁移。按需加载不等于偶尔用而是每类场景各归其位。防止忘记加载把加载触发器当成新的故障点拆分带来的最大风险是该读参考文件的时候没读。内容都还在仓库里不会报错行为只是悄悄退化——这是比崩溃更难察觉的故障。项目对此有明确的应对策略references/skill-authoring.md指针写成指令——在 Y 时加载 X而不是描述 X 里有什么漏加载是阻断性发现不是备注。修复手段是结构性强制比如该步骤没加载参考文件就不算完成而不是把措辞写得更强硬运行时兜底——核心文件要求一旦发现某类场景是在没加载参考文件的情况下处理的必须记录一条观察observation让漏加载有报案渠道。这套机制的聪明之处在于它承认加载触发器是单体文件没有的新故障点然后用记录强制步骤来管理它而不是假设 AI 总会乖乖照做。尺寸棘轮core_max_lines 只降不升渐进式披露要长期保持还需要同步防止核心文件悄悄变肥。这个项目的答案是尺寸棘轮技能在前置元数据里声明core_max_lines: 728即核心上限就是它今天的实测值校验脚本 scripts/validate-skill-bundle.py 在交付前做断言式检查核心文件一旦超限失败处理方式是把内容移到参考文件而不是把数字调大棘轮只能往下转上限只能降、不能升保证技能不会静默长过它已经所在的位置。文档还记录了一个真实教训references/skill-authoring.md阈值曾经是校验脚本里的一个常量结果一个技能超预算连累三个无关技能一起报错——一个技能为整个库提供的工具不应携带该技能自己的常量。所以上限必须来自被检查对象自己。给你的实践清单如何把渐进式披露搬进自己的项目如果你也在写 AI 技能、提示词工程文档或任何AI 每次都要读的文档可以直接照搬这 5 条均出自 references/skill-authoring.md核心文件只留心智模型 少数每次都生效的规则 带触发器的指针清单references/ 接管工具清单、配方、分类法、按变体展开的细节、长故障目录超过约 300 行的参考文件加目录让读取者可以跳读而不是通读每个指针写明加载触发器否则它会被当可选约 500 行是回头拆分的触发线——新文档从第一稿就拆分成本几乎为零老文档超过 500 行就该动手了。总结one-skill-to-rule-them-all 的渐进式披露架构本质上是一套把内容按使用频率分层的上下文经济学728 行核心SKILL.md承担每次触发的成本4620 行参考references/只在事件发生时付费配合触发器式指针 尺寸棘轮 漏加载即记录三道防线让大技能既完整又不昂贵。对新手来说最值得记住的只有一句话先问这段内容每次触发都用得上吗再用得上的留、用得上的移、移出去的标好触发器。【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-all创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考