SuperAPI AI 工具集

runtime-behavior-probe

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:调查真实运行时行为,而非复述代码或文档。先规划调查,再执行用例矩阵,记录观察结果,并同时报告发现与获取方法。该技能仅手动调用,不依赖隐式触发;在 node-redis 中属于一次性探针工作流,而非仓库实现工作流。

主要能力:编写临时 TypeScript 探针脚本;建立验证矩阵(含 case_id、scenario、mode、question、setup、observation_summary、result_flag、evidence 等列);控制状态(新鲜/复用、缓存复用或失效、唯一 ID 隔离、清理验证);支持单次、repeat-N、warm-up + repeat-N 等执行模式;对基准或对比探针要求先明确 parity(保持常量、被测变量、回复形状约束、计数或计时)。

使用方式:默认本地或只读探针;仅在明确相关时使用实时服务,并先通过目的地、意图、数据三道轻量门。执行前先写用例矩阵,再填入观察结果。node-redis 默认编写循环:tmpdir=$(mktemp -d),写入 probe.ts 与 tsconfig.json,从仓库根运行 npx tsc --noEmit -p "$tmpdir/tsconfig.json",通过后运行 npx tsx "$tmpdir/probe.ts";仅当探针有意导入 dist/ 或验证打包输出时才运行 npm run build。若探针需读取环境变量,须先告知确切变量名并等待明确批准,且绝不打印密钥。

适用场景:验证边界情况、漂移或失败行为;疑似回归或行为变化时加入已知良好对照;基准或对比调查;需要运行中 Redis 时先确认可达性、模式(standalone/cluster/sentinel)与 RESP 版本,RESP2 与 RESP3 应作为独立用例。

限制:写入范围限于临时目录,以及用户编辑本技能时的 .agents/skills/runtime-behavior-probe/;不得修改 examples/、packages/**、package.json、README.md、工作区或构建配置。临时产物默认在最终回复起草后删除,除非用户要求保留或后续需要;删除后仍保留简短运行摘要。报告顺序为:发现(意外或负面优先)、验证方法、用例结果、产物状态与运行摘要,可选实现说明。资料未提供具体收费、价格或平台信息。