SKILL 校验与本地预览
在提交或发布前,对 SKILL 文件的 YAML 头、必填字段与步骤编号做静态检查,并在本地预览渲染结果,减少「线上才发现格式错了」的返工。
可与 pre-commit 或 CI 集成:校验规则与团队编写指南对齐,未通过时给出可复制的修复建议。
本地预览侧重标题层级、代码块与边界说明是否适合直接投喂给模型。
建议将校验规则版本化:当编写指南升级时,同步 bump 规则集版本号,CI 日志里可一眼看出是「内容未改」还是「规则变严」。对大型单体仓库,可按路径 glob 启用不同严格度。
- 本地:提交前快速反馈,适合作者自修。
- CI:与分支保护配合,防止绕过本地钩子的提交。
- 预览:检查代码块语言标签与过长行,避免模型误读。
# 检查项示例
- name / description 非空
- 步骤序号连续
- 禁止占位符未替换