SuperAPI AI 工具集

skill-stocktake

编程与开发

查看项目

更新于 10-16 05:54

技能介绍

用途:Skill Stocktake 审计技能库(技能目录)的质量与覆盖度,检查 .github/skills/ 和 vscode-omg/resources/templates/skills/,输出健康报告。适合在新增技能前查重、大批量变更后核对模板同步、或定期清理陈旧/不完整技能。

主要能力:统计技能目录数量并检查每个目录是否含 SKILL.md;校验 SKILL.md 前置元数据(v1.0.5+),如 name 必填、kebab-case 且与目录名一致,description 必填并含触发关键词,argument-hint 可选;排查旧字段 hint:、已不支持的 allowed-tools:,以及 autopilot 命名冲突(应为 omg-autopilot);对比 .github 与模板目录,发现未同步或孤立模板;质量检查包括 name 与目录名一致、description 含触发关键词、有明确的“何时使用/步骤”及“输出格式/参见”章节、无失效交叉引用、非空 stub(少于 20 行视为可能不完整);覆盖率分析对比 copilot-instructions.md 中列出的技能与磁盘实际目录,找出缺失或多余项。

使用方式:在仓库根目录执行命令进行清点,例如 ls -1d .github/skills//、ls -1d .github/skills// | wc -l,以及循环检查 SKILL.md 是否存在;用 grep -rn "^hint:" .github/skills/、grep -rn "^allowed-tools:" .github/skills/、ls .github/skills/ | grep "^autopilot$" 排查旧字段与命名冲突;用 diff 对比两个技能目录;用 grep 从 copilot-instructions.md 提取技能名并比对实际目录。输出格式为 Skill Stocktake Report,含日期、总技能数、Inventory 表、Issues Found 表(类型/技能/问题/严重度)、Summary(通过数与待处理问题数)、Recommended Actions。

限制:资料未提供收费、价格、平台支持或性能数据;审计范围与规则以资料描述为准,未验证其他环境或版本的兼容性。