SuperAPI AI 工具集

codebase-review

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:对代码库做整体审计,而非逐行挑格式问题。适用于用户提出“codebase review”“architecture review”“codebase audit”等请求时,也用于本地 fork 子代理或 CI 工作流中消费报告。

主要能力:分四阶段进行。一、定位:读 CLAUDE.md、README 与架构文档,用 Glob、Grep 梳理入口、模块依赖图与数据流,识别技术栈及其惯例。二、审查:系统阅读源码,关注结构问题(类型/接口重复、死代码、缺少单一事实来源、编排函数职责过重、文件与目录拆分、管道中生成器与 I/O 分离)、健壮性问题(静默 catch、缺少守卫子句、错误处理不对称、重试逻辑陈旧)、可维护性问题(结构性重复、导入卫生、命名、定义顺序)、测试与验证(覆盖缺口、fixture 是否过时、解析输出是否做 schema 校验)、文档漂移(CLAUDE.md、README、.claude/rules/ 与实际代码是否一致)。三、报告:按影响而非文件组织,分 Critical、High、Medium、Low 四档;每条给出位置(path:line)、当前代码片段、失败模式说明、具体修复与前后对比、周边上下文;模式级问题列出全部受影响文件并只讲一次根因。四、修复:由报告消费方按档位顺序逐项处理,每批后运行 lint、测试、类型检查与死代码检查(如 {{check_command}} + {{test_command}}),并同步更新文档。

限制与边界:不做格式挑剔,交给格式化工具;不建议换语言或框架;不把个人偏好当工程问题;问题多时优先列最重要的 7–10 条;不为简单需求引入新依赖。报告必须完整自包含,因为本地主会话看不到子代理读过的文件与推理过程。具体命令、检查工具与项目约定以资料中提及的 CLAUDE.md 为准,其余细节暂未提供。