SuperAPI AI 工具集

measure

测试与质量

查看项目

更新于 10-16 00:23

技能介绍

用途:measure 用于回答“声称的改进是否真的发生、幅度多大”。它测量改动前(基线)到改动后的差值,适用于性能或代码度量类改进声明的核实。核心规则是:没有改动前采集的基线,就不能声称改进;若基线缺失,应如实报告当前测量值并说明无法量化改进,不得编造差值。

主要能力:支持两类指标族。performance 族涵盖墙钟时间、内存、分配、吞吐、延迟等运行时资源指标,读取 context/performance.md;metrics 族涵盖复杂度、覆盖率、CRAP、耦合、重复度等代码形态指标,读取 context/metrics.md。命令可解析指标族与阶段参数,默认阶段为 compare。

使用方式:规划阶段若计划包含可量化目标,先执行基线阶段采集改动前测量值,存入主题记忆层的 baselines/ 目录,并在计划中记录基线值与目标值;改动后执行默认比较阶段,在相同条件下复测并与存储的基线比较,得出核实结论。无指标族参数时可根据声明推断:运行时资源声明归入 performance,代码形态声明归入 metrics;若声明模糊需先询问针对哪种资源。两个阶段前都需确认机械通过状态为绿色,可复用本次对话中的检查结果,或调用项目的构建与测试命令。

适用场景:计划中写明可量化目标时、在确认、评审或对话中出现无数据的改进声明时、以及需要将比较摘要写入计划产物或 PR 正文时。

限制:本技能不确认意图与结果,不做发布就绪性评审,不事后补采基线,不运行构建测试与静态检查。条件漂移会使比较失效;若预计节省落在运行间波动范围内,则改动不可测量;基线缺失、方差过大或条件不一致时应如实给出 INCONCLUSIVE 或 NOT CONFIRMED,不得编造数值。