SuperAPI AI 工具集

audit

测试与质量

查看项目

更新于 10-16 07:29

技能介绍

用途

audit 是一个综合项目审计技能,用于对项目进行整体质量检查。它的定位是:单个 validate-/scan- 技能只显示“缺什么”,而 audit 负责编排全部验证技能并指导“如何改进”。

主要能力

  • 动态发现并依次运行所有可用的验证技能(standards 插件中匹配 validate* 的技能,devtools 插件中匹配 validate* 或 scan-* 的技能)。
  • 每个技能必须全深度执行,而非简单模式匹配;执行后输出带 Status 与 Evidence 列的强制输出矩阵。
  • 对每个类别分配状态:PASS / NOT_APPLICABLE / SKIPPED / SHALLOW。
  • 技能间设有门禁:进入下一个技能前,确认当前技能矩阵没有空的 Status 或 Evidence 单元格。
  • 对未安装插件中的技能进行优雅跳过,且不影响整体评级计算。
  • 执行分类深度审计,覆盖 Rules、Skills、Agents、Settings、Commands 等类别的具体检查项。
  • 参照设计规则文件,为每个薄弱项提取具体改进步骤。
  • 输出综合审计报告,包含当前状态、改进动作、预期结果变化,以及按严重程度排序的改进优先级清单。
  • 将结果持久化到 .ww-w-ai/standards/audit/,包括 latest.json、latest.md 及 history/ 归档。

使用方式

  • 目标目录:当前项目根目录(自动检测)。
  • 无需额外输入。
  • 执行流程:
    1. 发现并运行所有验证技能(全深度执行)。
    2. 识别薄弱区域,按优先级排序。
    3. 执行分类深度审计。
    4. 参照设计规则。
    5. 输出前检查清单。
    6. 输出改进建议。
  • 执行顺序:validate-cc 始终最先,随后是其他 standards 的 validate-* 技能(按字母序),再是 dev 的 validate-/scan- 技能(按字母序)。
  • 输出报告使用用户对话语言;JSON 字段名保持英文。

适用场景

  • 需要对项目进行整体质量审计时。
  • 需要跨多个验证维度(配置、文档、Git、安全、架构、测试等)汇总问题并给出改进路径时。
  • 需要机器可解析的历史记录与跨运行对比、趋势分析时。

限制

  • 改进工作由用户直接执行,audit 本身不修改项目源码。
  • 写入权限仅限于 .ww-w-ai/standards/ 输出持久化。
  • Bash 权限仅限于只读的 git/系统查询,以及目录创建(mkdir -p .ww-w-ai/standards/audit/history)和 Grep 模式匹配。
  • 若设计指南文件缺失,则提供默认指导。
  • EMPIRICAL 证据类型的条目基于经验,可根据项目上下文调整。
  • 未安装插件中的技能会被跳过,不影响整体评级。
  • 关于具体收费、价格、平台支持等信息,资料中暂未提供。