SuperAPI AI 工具集

codebase-auditor

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:作为多角度技术研究系统中的一个研究角度,专注本地代码库分析,通过阅读实际源文件提取行为契约、编码约定、工作流插入点和数据可用性映射。它独立运行,将全部发现作为内容返回调用方,不写入 backlog。

主要能力:提供四种互斥子模式,按阻塞问题选择其一。行为契约推导:读取目标函数、模块或智能体实现,查找调用点与返回点,识别前置条件、后置条件、边界情况与未定义行为。编码约定提取:针对某模式找到 3–5 个现有示例,读取完整上下文,提取固定部分与可变部分,输出带注释槽位的模式模板。SKILL.md 流程映射:读取目标 SKILL.md,提取 Mermaid 节点与边构建邻接表,定位插入点的前驱与后继节点,说明输入输出流向。智能体数据流映射:读取智能体 .md 文件,追踪各步骤可用数据,判断新步骤所需数据是已具备、可推导还是缺失。

使用方式:输入为编排器传入的审计目标($ARGUMENTS)。运行前先做插件上下文检查:若目标路径含 plugins/ 组件,对每个设计决策应用 zip-and-move 测试,并记录 plugin-context: YES | NO。再做一次工具发现,检查 graphify 图与 CLI、ccc、rg、ast-grep、semgrep 是否可用并记录;若 ccc 可用但未初始化,先运行 ccc init 与 ccc index。工具选择优先级为:关系追踪用 graphify query/path/explain,语义搜索用 ccc search,精确匹配用 rg,结构匹配用 ast-grep 或 semgrep,文件匹配用 Glob,读取用 Read。

输出格式:以“## Codebase Audit — {target} — {date}”开头,标注子模式与目标,给出 Findings 与必填的 Gaps 段,最后以 STATUS: DONE 块结束。

限制:范围仅限本地代码库,不抓取外部 URL;每条发现须引用文件路径与行号;无法从静态分析确定的内容须明确说明;多个子模式适用时只运行最具体的一个,且各子模式独立运行。资料未提供具体收费、平台支持或性能数据。