Front Matter

先把两种不同层级的 front matter 区分开。

1. 文档页面自身的 Frontmatter

这个文档站点中的每个 MDX 页面目前至少需要：

• title
• description

可选字段包括：

• sidebarTitle
• status
• keywords

2. 同步系统中的 frontMatter 配置

frontMatter 配置块目前只暴露一个字段：

{
  "frontMatter": {
    "blankLineAfter": true
  }
}

它的职责不是描述页面本身，而是控制输出时是否在 front matter 后保留一个空行。

如果你要找的是 tabSize、indent 这类轻量级个人缩进偏好，那么它们现在位于 ~/.aindex/.tnmsc.json 中独立的 codeStyles 配置块，而不是 frontMatter。

3. 源内容的 Frontmatter

不同输入类型也会在各自源文件的 frontmatter 中保存 description、触发条件、工具约束等字段。多个输出插件会读取这些字段来映射目标元数据。

这里有一个重要例外：

• skills 不再从 frontmatter 读取 name，而是直接使用 skill 目录名
• subagents 不再从 frontmatter 读取 name，而是改为从相对路径推导名称
• 如果旧的 name 字段仍然存在，它会被忽略，并发出警告

这些输入类型之间的边界可参见技术细节。

总结

• Docs frontmatter 用于文档站点本身
• frontMatter 配置用于控制输出行为
• codeStyles 是单独的配置块，用于保存缩进等轻量级代码风格偏好
• 源内容 frontmatter 用于同步系统和输出插件，但 skills 与 subagents 现在从路径而不是 name 获取名称

这三者关注的是完全不同的问题。