---
name: template-frontmatter-parser
type: pattern
when: 'frontmatter, template_schema_loader, 模版加载, YAML解析'
scope: ['*']
products:
  - '*'
id: cap-kdoc-template-schema-loader
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
priority: P2
specificity: 2
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
stages: ["*"]
owner_mechanism_id: mc-engine-runtime
---

# 模版 Frontmatter 解析加载器

## 概述

从模版文件的 YAML frontmatter 中解析 artifact_schema 和 process_rules 定义。
支持运行时重载（开发时修改模版立即生效）。

## 何时使用

- 开发时修改模版 frontmatter 中的 Schema/ProcessRules 定义后立即生效
- 运行时从模版文件动态加载结构约束
- 当需要覆盖注册中心中的硬编码 Schema 时

## 是否 hard block

advisory — 模版 frontmatter 是开发态便利功能，不 hard block 管线执行。
无 frontmatter 的模版使用注册中心默认值，不阻断。
解析失败时 fallback 到注册中心，不阻断流程。

## 证据要求

- 4 个 P0 模版 frontmatter 解析测试通过
- 批量加载返回正确的模版数量
- 转换函数能正确生成 registry 兼容的 ArtifactSchema

## 人工确认/降级边界

- 解析失败不阻断，自动 fallback 到注册中心
- frontmatter 中的 Schema 定义覆盖注册中心硬编码值时需 review
- 不影响已有模版的无 frontmatter 兼容性

## 使用方式

- `parseTemplateFile(path)` — 完整文件解析
- `loadTemplateSchemas(dir)` — 批量加载目录下所有模版
- `toArtifactSchema(parsed)` — 转换为 registry 兼容格式
