SuperAPI AI 工具集

deep-audit

编程与开发

查看项目

更新于 10-16 04:59

技能介绍

用途:deep-audit 用于对代码仓库做确定性审计并编排重构,支持结构化深度、中等或低度审计。

主要能力:三种核心模式——project(审计整个仓库与横切架构)、section(审计一个受限区域,如模块、层、包、服务或文件夹)、feature-trace(跨所有涉及文件和层审计单个特性)。深度预设见 references/mode-matrix.md。执行连续性模式有 section-lock(section 开始后直到审计、重构与验证完成才停止)和 full-lock(重构开始后直到整个审计范围完成才停止);section 模式默认 section-lock,project 与 feature-trace 默认 full-lock。

使用方式:审计前先理解项目意图与约束,将目的、业务流和关键用户旅程写入 system-understanding.md,存在歧义时用选项加一个推荐选项提问,并将回答记入 clarifications.md。每次审计需生成审计地图、系统理解、澄清记录、实施计划、任务、路线图及分区文件。可用命令:node agent/deep-audit/scripts/init_dynamic_audit.js --mode <project|section|feature-trace> --depth <deep|medium|low> --scope "<target>",以及 node agent/deep-audit/scripts/init_section_audit.js --audit-root "work-items/audits/<audit-id>" --section "<section-name>" --order <nn>。流程分阶段执行:系统发现、Phase 0 门禁、构建审计地图、逐区审计、维护审计级工作项包、实施重构、验证收尾、提交与推送门禁;各阶段用 node agent/deep-audit/scripts/run_phase_checks.js --phase "<phase>" 检查。

适用场景:需要对完整仓库、单个模块或跨层特性做结构化审计、重构规划与验证的开发工作。

限制:存在多项不可协商规则,如未生成 audit-map.md 不得开始重构、无文件级证据不得报告发现、未通过阶段门禁不得跳过(除非记录阻碍与用户决策)、验证失败不得推送;若用户使用乌兹别克语提问或要求乌兹别克语,对话与报告需保持乌兹别克语。