用途:让 skills/ 目录下的每个 SKILL.md 重新符合 CI 强制的 frontmatter 合约,从而通过脚本 scripts/validate-frontmatter.py 的校验。
适用时机:在新增或编辑任何 SKILL.md 之后,或 CI 的“SKILL.md frontmatter validation”任务失败时。
操作步骤:先运行 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 门禁约束,但应遵循同样的风格。