SuperAPI AI 工具集

measurable

数据与分析

查看项目

更新于 10-16 06:49

技能介绍

Measurable 的核心目标是把“已发布”和“可观测”变成同一件事:一个改动只有在影响可度量、回归可被发现时才算完成。它用于决定一次 diff 需要哪些遥测,编写或审计这些遥测,并按仓库记录可观测性档案,避免每次重新推导。

用途与主要能力:按改动类型分类(前端 Web、前端移动端、后端/API、基础设施或混合)。前端面向用户的事件设计交由 rum-tracking 处理,本技能只判断是否需要 RUM 并转交;后端 span、指标与结构化日志按内置规则处理,安装时可委托 otel-instrumentation 与 otel-semantic-conventions。为每项改动指出具体的回归信号,例如“POST /checkout 的 P99 延迟已被跟踪并在基线 2 倍时告警”,而不是仅“加了日志”。信号新增或重命名时运行 Weaver 模式检查。同时按规则保证错误和告警不被静默吞掉。

使用方式:解析 $1 作为模式,先用一行说明检测到的模式。guide 为默认模式,回答需要哪些遥测;implement 用于添加遥测;audit 用于检查覆盖率,可传 --diff 或目标文件/目录;setup 用于首次建立可观测性档案。审计输出按 missing、unlinked、pass 分类并标注文件路径和行号,默认仅提示,传 --strict 后 Web/移动端/API/worker 路径上的 missing 会阻断调用方门禁,unlinked 仍仅提示。审计模式不会自动修改文件。

限制:依赖 rum-tracking、otel-instrumentation、otel-semantic-conventions、persistent-memory 与 Weaver CLI 时均为可选,缺失则降级到内置规则并输出一行跳过说明,不阻断。本技能只写应用层遥测,不直接创建或编辑仪表盘、告警与 SLO,需通过 Dash0 chat 提议由人工审核。初始化模式在技术栈变化或新增包时需要重跑,剧本幂等。具体命令与代码示例资料未完整提供。