SuperAPI AI 工具集

repo-maintainer

测试与质量

查看项目

更新于 10-16 09:28

技能介绍

用途:审计仓库健康状况,在授权范围内做最小化修复,并通过仓库自有的受保护流程收尾。适用于用户要求维护、清理、审计、加固或为发布做准备的仓库;若任务以安全、数据库、部署或发布为主,应改用更专门的技能。

使用前策略门:变更前需阅读根目录与嵌套 AGENTS.md、贡献指南、维护者文档与发布说明;检查当前分支、工作区、暂存文件、远程、默认分支与生效的分支保护;发现仓库原生的验证、同步、合并与发布命令;保留无关的用户改动与不在范围内的生成产物。若仓库指定了强制维护技能或受保护命令,应委派给它,而不是另建分支、合并、同步或发布路径。

基线检查命令:git status --short --branch、git diff --stat、git diff --cached --stat、git remote -v、git log -5 --oneline。

审计范围:产物与 Git 卫生(未跟踪缓存、覆盖率、构建输出、编辑器文件、测试残留;大文件或二进制、意外密钥、可执行位漂移、忽略规则缺口;陈旧分支、游离 HEAD、子模块、符号链接;应由 CI 或规范同步工作流拥有的生成文件),审计期间不得删除或改写历史。依赖与打包(锁文件与清单一致、过期或有漏洞依赖、导入误放开发依赖、干净安装与包内容)。CI 与发布健康(失败或陈旧工作流、过宽运行时矩阵、未固定动作、必需检查与分支保护、文档与实现的发布命令不一致)。文档与元数据(README、变更日志、版本、示例、链接、贡献说明与 PR 模板)。代码质量信号(死代码、陈旧实现标记、调试日志、注释掉的代码、缺失测试、不安全默认值、抑制错误、凭据暴露)。FAF 项目还需用项目自带 FAF 命令检查 .faf、.faf-dna、同步、评分与 MCP 契约。

产出优先级决策集:每条发现给出证据与受影响路径、严重程度与用户影响、是立即可修还是需批准或属于其他工作流、证明修复的确切验证。

修复与验证:做最小自洽变更,区分源文件与生成文件归属,行为变更同步更新测试,每组修复后重跑目标检查。未获明确授权,不得删除数据、改写历史、轮换凭据、更改分支保护或跨破坏性版本升级。运行仓库要求的 PR 前套件,检查最终差异是否含无关文件或密钥,在主题分支提交并在受保护目标分支上创建 PR,使用必需检查与仓库原生合并路径。用户要求“推送到 main”只描述目标状态,不绕过分支保护。

停止条件:所有范围内发现已修复或各有一个确切阻塞点,必需验证通过,被请求时远程集成路径已验证,且无关用户工作保持不变。

限制:发现可能依赖仓库特定的归属与发布政策,行动前须阅读本地说明;依赖与安全扫描器可能产生误报或不完整的可达性证据;本技能不授权超出用户请求的破坏性清理、分支政策变更、直接推送受保护分支、合并、部署或发布。