YAML frontmatter
可以先理解为:Skill的机器可读摘要元数据
像文件开头贴的一张标签卡,告诉系统这份文件是什么、什么时候该看。
关键结构图
中心节点写「YAML frontmatter」,周围连接 Skill anatomy、Progressive disclosure、Reusable expertise,用细线表示相邻路径和调用方向。
What
YAML frontmatter 是一种文件结构:在 markdown 文件开头用 YAML 写元数据,方便系统读取、索引、匹配和加载。
When
当你需要理解模型之外还有哪些基础设施支撑 AI 能力时,可以用「YAML frontmatter」命名这块砖,再连接相邻概念继续判断。
How
在 agent skill 中,frontmatter 是 progressive disclosure 的入口:系统先读元数据判断是否加载完整 skill。
Examples
在拆解一个 AI 系统为什么能稳定运行时,你可以用「YAML frontmatter」标记其中最需要被看见的结构,再检查它提供了什么证据、边界或行动方向。
在整理「AI 基础设施」主题时,把「YAML frontmatter」和「Skill anatomy」放在同一路径里,可以帮助读者从单点概念走向可复用的判断框架。
来源
类型:系统结构 / 概念整理
事实线:这张卡把「YAML frontmatter」整理为概念提炼: YAML frontmatter 是一种文件结构:在 markdown 文件开头用 YAML 写元数据,方便系统读取、索引、匹配和加载。
依据:1000 Bricks 本地砖块库的概念定义、相邻砖块关系和AI 基础设施、系统架构和工具链讨论。
边界:适用于「AI 基础设施、算力、存储、运行时和工具系统」主题下的理解、复盘和设计判断;不等于行业统一标准或对所有场景都成立的结论。
常见误读:不要把它当作某篇材料的原文摘要,也不要因为概念名清晰就忽略具体情境和验证证据。