SuperAPI AI 工具集

repo-audit

编程与开发

查看项目

更新于 10-16 03:16

技能介绍

用途:对仓库做一次只读调查,回答“目录中哪些技能适用于此仓库、应按什么顺序处理”。它只做分诊,不应用修复,也不做应用逻辑、测试或业务行为的代码审查。

主要能力:脚本对每个目录技能输出一行检查结果,状态为 pass、warn、missing 或 skipped。检查项包括 prek(prek.toml 或 .pre-commit-config.yaml)、oss-hygiene(LICENSE、CODE_OF_CONDUCT.md、CONTRIBUTING.md、SECURITY.md、.github/ISSUE_TEMPLATE、PULL_REQUEST_TEMPLATE、.github/dependabot.yml 及 scorecard/codeql/dependency-review 工作流)、gh-bootstrap(.github/release.yml,加 --github 时还查合并设置与非空 rulesets)、safe-settings、config-review-bot、release(git tag --list 与 CHANGELOG.md)、justfile、ci-optimize、build-optimize(跳过,需实测墙钟数据)、github-copilot-repo-instructions、codeowners、actions-pinning(统计未固定到 40 位十六进制提交 SHA 的 uses: 引用)、pr-title-lint、labels-as-code、repo-attributes、branch-cleanup(需 --github)、agents-md(AGENTS.md 存在且小于 32 KiB、约 200 行以内)。

使用方式:在仓库根目录运行 python3 skills/repo-audit/scripts/repo_audit.py。加 --github 可额外执行只读 gh api GET 调用(合并设置、rulesets、delete_branch_on_merge、CODEOWNERS 错误端点),该参数为可选,默认只读工作树与本地 git 元数据。用 --json 供机器消费,用 --markdown 把表格贴入 PR 评论。脚本除非自身出错否则始终退出 0,missing 或 warn 行不算脚本失败。

限制:不创建、编辑或删除文件,不调用 POST、PATCH、PUT、DELETE 端点,--github 只增加 GET。若用户要求“直接修好”,应拒绝并重申路由计划。skipped 表示该检查需要脚本无法静态获取的数据或未传 --github,不代表仓库未通过。审计不能替代阅读对应技能的 SKILL.md。参考资料见 references/checks.md。