SuperAPI AI 工具集

refresh-index

数据与分析

查看项目

更新于 10-16 00:02

技能介绍

用途:refresh-index 用于刷新 ASM 精选技能索引中所有已启用的仓库,使 data/skill-index/{owner}_{repo}.json 反映上游最新状态。它是 skill-index-updater 的反向操作:后者从用户提供的 URL 添加新仓库,本技能只刷新 data/skill-index-resources.json 中已启用的仓库。

主要能力:编辑前强制同步远程分支(git fetch、git pull --rebase,必要时 stash 本地改动);枚举已启用与已禁用仓库;快照刷新前的 skillCount;运行 npm run preindex 重新抓取;依据 preindex 日志与 git diff 将仓库分类为 updated、unchanged、failed、skipped;运行 npx tsx scripts/build-catalog.ts 验证目录可重建;检测 diff 范围是否异常;输出四桶汇总表;在用户明确确认后提交并创建 PR。

使用方式:需 node、npm、asm、gh(已认证)、git 及 github.com 网络访问。按步骤执行:读取 data/skill-index-resources.json 并用 jq 拆分 enabled/disabled;用 jq empty 预校验现有 JSON;快照 skillCount;运行 npm run preindex 并记录日志与退出码;分类;重建目录;检查 diff;打印汇总;最后需用户输入 yes 才执行 git add data/skill-index/、提交、推送和 gh pr create。

适用场景:维护 ASM 技能索引、批量同步上游仓库变更、生成仅含数据变更的 PR。

限制:不得提交 website/catalog.json(已被 gitignore);不得提交 data/skill-index/ 之外的混合改动;preindex 失败或 build-catalog 失败时须停止;无已启用仓库、预校验失败、rebase 冲突、gh 未认证等情况需停止并询问用户;提交与推送前必须获得明确确认。