SuperAPI AI 工具集

lov-gh-tidy

部署与运维

查看项目

更新于 10-16 00:01

技能介绍

lov-gh-tidy 是一个交互式 GitHub 仓库卫生(triage)技能,用于在一次流程中集中处理开放 issue、PR、陈旧分支和孤立标签。

用途:帮助维护者快速掌握仓库状态,逐项分析并决定关闭、合并、删除或保留。

前置条件:已安装并认证 gh CLI(gh auth status);当前目录是带 GitHub 远程仓库的 git 仓库。

工作流程:

  1. 扫描:并行运行 gh issue list、gh pr list、git branch -r --no-merged origin/main(排除 main/master/develop)以及 gh label list,收集仓库状态。
  2. 汇总:按类别输出简洁表格,包括 issue 的编号、标题、作者、时长、评论数、标签;PR 的编号、标题、作者、时长、可合并性、评审状态;30 天以上无提交的陈旧分支及最后提交日期;未被任何 issue/PR 使用的孤立标签。每项附简要分析,如 issue 是否可操作、是功能请求还是缺陷;PR 是否有冲突、代码是否有价值;分支是否已合并或废弃。
  3. 分诊:使用 AskUserQuestion 按类别询问处理方式。issue 可选:致谢后关闭 / 标记 wontfix 关闭 / 保持开放 / 添加标签;PR 可选:评审并合并 / 不合并关闭 / 保持开放;分支可选:删除 / 保留;标签可选:删除 / 保留。询问前必须展示分析与理由。
  4. 执行:通过 gh CLI 执行所选操作,例如 gh issue close <N> --comment "message"、gh pr merge <N> --squash、gh pr close <N> --comment "message"、git push origin --delete <branch>、gh label delete <name> --yes。
  5. 报告:输出操作汇总,如关闭/保留的 issue 数、合并/关闭的 PR 数、删除的分支与标签数。

规则:始终先分析再询问;PR 有冲突时先在本地解决再推送合并;关闭外部贡献者的 issue/PR 时留下礼貌致谢评论;绝不强制推送或删除受保护分支;跳过零项类别;大型仓库(50+ 项)按类别分批询问。

运行时上下文:运行前读取 Skill 包的 skill.yaml,由宿主提供 skill-runtime/v1 上下文,字段解析顺序为当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值;仅使用 Manifest 声明的字段。required 字段缺失时按 Manifest 配置提出一个聚焦问题,用户明确同意后再保存。报错需提供可复制的 context_id、字段路径与来源,诊断避开秘密、完整私人路径和原始配置。

反馈闭环:用户提出修改意见时,先判断是 task-specific(仅本次)还是 reusable(可跨任务复用)。task-specific 只改当前任务;reusable 先确定作用域,领域规则更新对应 canonical Skill,通用规则更新共享规范,完成规则更新、版本、lint 与分发核验后再应用到当前任务。reusable 修改会使此前的确认失效,完成修改和回读后必须停下等待用户指示,不自动进入发布或外部写入。

限制:依赖 gh CLI 与 GitHub 远程仓库;具体收费、平台支持范围等资料暂未提供。