用途
test-audit 用于在审查测试质量或清理测试时使用,可针对一个聚焦范围,也可覆盖整个测试套件。其核心目标是:在成本合理的前提下,优化测试带来的可信度和有效反馈;保留有意义的契约;把可疑的测试形态视为需要调查的线索,而不是删除的依据。
主要能力
技能按六个步骤组织工作:
-
设定范围与权限。根据用户已有指令确定范围和模式。审计模式指仅检查、审查或建议而不编辑;清理模式指用户要求清理、修剪、修复或落实发现时,授权对范围内的测试及测试支持文件进行编辑。若涉及的是一般仓库、单体仓库或子系统的全部测试,则阅读 references/campaign.md,使用其穷尽式清单和分批顺序。没有具体任务而直接调用时,默认进入审计模式。产品行为、公共 API、依赖、CI 门禁和覆盖率阈值均在测试清理范围之外,除非另行授权。
-
发现项目与建立基线。读取适用的根级和范围级指令,并通过 /swarm 并行委派可分离的发现工作,默认启动三个只读子智能体:测试清单、生产行为、测试价值。识别实际存在的单元、组件、集成、契约、端到端、视觉、属性、架构和工具测试,包括同目录测试和由 CI 执行的嵌入示例。记录共享夹具与跨包消费者。记录起始版本和工作区状态,在编辑前运行相关基线命令。
-
评估并记录决策。对每个测试确定:它保护的可观察行为、不变量或独立需求是什么;什么样的可信错误实现会让它失败;其预期结果能否与实现不一致;是否在公共接口或稳定边界上;相比其余测试有什么独特贡献;以及其反馈与成本是否合理。决策分为 KEEP(保留)、REPAIR(修复)、CONSOLIDATE(合并)、DELETE(删除)和 UNRESOLVED(未决)。编辑前维护一份简明的台账,记录价值、决策与证据。
-
按行为应用清理。按拥有该行为或子系统的分组进行编辑。先转移独特用例,再删除旧位置。修复已记录的测试缺陷,从根源修复不稳定问题,而不是用重试替代。移除新增的未使用夹具、导入、快照、辅助函数和设置,同时保留其他包使用的支持文件。
-
验证保留情况。在验证期间保持文件稳定,先运行最小受影响套件,再运行相关同级和跨包消费者以及仓库要求的门禁。通过 /swarm 委派一个未提出相关更改的子智能体进行保留比较,对照原始契约与存活断言,检查独特输入、错误、边界、安全、可访问性、顺序、交互、集成路径和 CI 环境。
-
报告。说明结果是只读审计、已完成的清理还是部分工作。汇总决策与代表性发现,列出范围与清单核对、删除或合并的测试及其契约现在由谁保护、修复的测试、基线与最终验证对比、失败与未执行检查,以及需要单独处理的产品缺陷或生产简化。
使用方式
技能本身以指令形式提供,用户在工作流中调用 test-audit,并给出审查范围与模式。若需要清理,明确要求清理、修剪或修复即可获得范围内的编辑授权。技能会依据用户已有指令操作,不会在未授权时改动产品行为、公共 API 或 CI 门禁。
适用场景
- 审查某个模块或整个仓库的测试质量,了解哪些测试真正提供了有效反馈。
- 清理冗余、脆弱或维护成本过高的测试,同时不丢失有意义的契约。
- 修复测试缺陷,如不稳定的测试、模糊的失败信息或薄弱的断言。
- 建立测试台账,记录每个测试的价值、决策与证据,便于团队复核。
限制
- 产品行为、公共 API、依赖、CI 门禁和覆盖率阈值不在测试清理范围内,除非另行授权。
- 无法确认预期行为的测试应保留并标记为未决,等待澄清。
- 技能文档未提供具体价格、收费、平台支持或安装命令等信息,这些事实暂未提供。
- 文档提到改编自 OpenClaw test-audit 及其 campaign 工作流,更新上游材料或署名之前需阅读 UPSTREAM.md 了解来源修订、许可证和本地改编。