用途:在提交或创建 PR 前对 skills-for-fabric 仓库中 skills/ 文件夹下的所有技能运行本地质量检查,提前发现问题。适用于新增或修改技能后、提交技能变更 PR 前,以及校验交叉引用和语义冲突时。
依赖:Python 3.8+,需安装依赖:pip install PyYAML requests
用法:在仓库根目录运行 python .github/workflows/quality_checker.py(Windows PowerShell 下先 cd 到仓库目录再执行同命令)。
结果:脚本生成 quality-report.json,含 overall_status、critical_count、warning_count、semantic_conflicts、duplicate_triggers、broken_references、structural_issues、content_warnings、skills 等字段。退出码:0 表示通过或仅有警告,1 表示存在必须修复的关键问题,2 表示脚本错误。
关键检查项:YAML frontmatter 中 name 与 description 是否存在、description 长度不超过 1023 字符、更新提示块引用、交叉引用路径可解析、触发短语唯一、描述语义重叠不超过 70%。警告项包括描述接近长度上限(≥900 字符)、Must/Prefer/Avoid 指导段落、示例、代码块语言标签、描述中提及技术、命名规范、外部链接可访问性抽查。
限制:资料未提供价格、平台支持范围与实际效果数据;检查需在本地仓库环境运行。