SuperAPI AI 工具集

synthesis-codebase-review

编程与开发

查看项目

更新于 10-22 17:14

技能介绍

用途

这是一个面向各类规模项目的代码库审计方法论。它不要求每个项目执行全部检查,而是通过分层系统,让审查力度与项目的重要程度相匹配。

主要能力

  • 分层检查体系:Essential(Tier 1)、Standard(Tier 2)、Enterprise(Tier 3)、Mission-Critical(Tier 4)四级,各层级包含约 50、150、400、900+ 项检查。
  • 项目复杂度评估:从规模与用户、业务关键性、数据敏感性、架构复杂度、运维要求五个维度打分,依据总分确定层级。
  • 预检清单:审查前确认分支、排除目录、既往审查情况、输出格式与受众。
  • 增量审查模式:基于既往审查结果,将每条旧发现分类为 Fixed(已修复)、Partially Fixed(部分修复)、Still Present(仍存在)、Worse(恶化)或 New(新增)。
  • 密钥扫描:所有层级均列为关键检查项。
  • 实用可核查的检查项:每条检查项针对真实问题,且表述方式便于 AI 助手评估。

使用方式

  1. 完成项目复杂度评估以确定适用层级。
  2. 按层级选择检查章节:Tier 1 仅关注 Essential 项;Tier 2 加入 Standard 项;Tier 3 加入 Enterprise 项;Tier 4 包含全部。
  3. 审查前执行预检清单。
  4. 撰写报告时遵循“先优势、后发现”的顺序,每条发现引用文件路径与行号并给出具体整改步骤。

参考文档

  • references/detailed-checklist.md:16 个类别及附录的全部检查项,每项标注所属层级,审查时按项目层级阅读。
  • references/quick-check-and-categories.md:15 分钟最小可行审查,以及 16 个类别和附录各一段概述。
  • references/report-formats.md:Tier 1-2 报告模板、Tier 3-4 完整报告、增量审查模式及交付物归档方式。
  • references/background.md:本技能与 implementation-integrity、code-audit、preflight、pr-review 的关系及五项核心原则。
  • references/coverage-map.md:1.0.0 版本各部分内容的当前位置说明。

适用场景

单人/业余项目、原型与内部工具(Tier 1);小型团队项目、生产应用、初创公司(Tier 2);大型团队、受监管行业、企业客户(Tier 3);金融系统、医疗健康、关键基础设施(Tier 4)。

限制

审查效果依赖准确的复杂度评估与预检信息;检查项的具体内容需查阅上述参考文档,本文未逐条列出。