SuperAPI AI 工具集

repo-maintenance-node

部署与运维

查看项目

更新于 10-15 20:14

技能介绍

用途:对 Node.js 与 TypeScript 仓库做一次较全面的健康巡检,覆盖格式化、Lint、类型错误、死代码、依赖卫生、跨包一致性以及开放的 Renovate PR。运行任何检查前会先读取 AGENTS.md(不存在则读 CLAUDE.md)获取仓库专属命令。

参数:--dry-run 可选,只报告问题不做修改;--section <name> 可选,仅运行指定部分,有效值为 formatting、dead-code、deps、renovate,省略则运行全部。

执行方式:先做配置发现(读取 AGENTS.md/CLAUDE.md 与 package.json,识别脚本、包管理器、是否 monorepo),随后并行启动 Agent A(死代码检测)与 Agent B(依赖与 Renovate),两者完成后再运行 Agent C(代码质量:格式化、Lint、类型检查),最后合并结果生成报告。依赖部分内部有顺序约束:Renovate PR 需先完成,再过滤过时依赖。

主要能力:死代码检测优先使用 knip,未配置时用启发式扫描导出符号与无入站引用的文件,仅报告不自动删除;依赖部分列出开放的 Renovate PR(gh pr list --author "renovate[bot]" --state open),建议对每个 PR 运行 /renovate-review,检查 monorepo 跨包版本一致性、锁文件重复(pnpm dedupe --check、npm dedupe --dry-run、yarn dedupe --check)、未被 Renovate 覆盖的过时依赖(pnpm outdated 等,按 patch/minor/major 分类)以及 peer 依赖告警;代码质量部分运行仓库配置的格式化、Lint(--fix)与类型检查(tsc --noEmit),修复简单问题并标记复杂类型错误供人工复核,改动按部分分别提交。

限制:死代码检测为建议性,不自动删除;peer 依赖问题不自动修复;--dry-run 时零改动;工具缺失则跳过并在报告中注明;具体命令以仓库 AGENTS.md/package.json 为准。