关于 fix-frontmatter
用于修复 `skills/` 下 `SKILL.md` 前置元数据的 Skill，面向维护技能文件和处理 CI 校验失败的开发者。它通过运行验证脚本、按报告修正字段并重复验证，确保文件符合约定。
主要功能
- 01运行前置元数据验证脚本
- 02按规则修正名称和版本格式
- 03将 homepage 替换为 documentation_url
- 04检查分隔符与必需字段
- 05重复验证直至检查通过
适用场景
- 01新增或编辑 SKILL.md 后检查格式
- 02处理 CI 前置元数据校验失败
- 03批量修复 skills/ 中被标记的文件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/fix-frontmatter确认已加载。
详细介绍
修复 Frontmatter
目标
让 skills/ 下的所有 SKILL.md 重新符合 CI 强制执行的 frontmatter
契约，确保 scripts/validate-frontmatter.py 通过。
使用时机
添加或编辑任何 SKILL.md 后，或 CI 的“SKILL.md frontmatter
验证”任务失败时。
步骤
- 运行
python3 scripts/validate-frontmatter.py，阅读报告的所有问题。 - 对每个标记的文件，修复 frontmatter：
name:→ 使用 kebab-case，并以deepworkplan开头（例如deepworkplan-create）version:→ 加引号的 SemVer（"2.8.0"）- 将
homepage:替换为documentation_url: - 确保存在
---分隔符和必需的键
- 重新运行验证器，直到其输出
OK: all N SKILL.md file(s) validated。
验证
python3 scripts/validate-frontmatter.py 以状态码 0 退出。
备注
切勿为了通过检查而编辑 version: 数字——只修复引号或格式。auto-release.yml 机器人负责管理版本号（AGENTS.md §4）。验证器只扫描 skills/；.agents/skills/* 不受 CI 检查，但应遵循相同的风格。
评论
支持 Markdown