用途
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/ 归档。
使用方式
- 目标目录:当前项目根目录(自动检测)。
- 无需额外输入。
- 执行流程:
- 发现并运行所有验证技能(全深度执行)。
- 识别薄弱区域,按优先级排序。
- 执行分类深度审计。
- 参照设计规则。
- 输出前检查清单。
- 输出改进建议。
- 执行顺序: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 证据类型的条目基于经验,可根据项目上下文调整。
- 未安装插件中的技能会被跳过,不影响整体评级。
- 关于具体收费、价格、平台支持等信息,资料中暂未提供。