SuperAPI AI 工具集

circuit-surface-test

测试与质量

查看项目

更新于 10-16 08:03

技能介绍

用途:在指定宿主(Claude Code 或 Codex)中,手动走查 Circuit 插件的全部用户可见界面,寻找回归、进度渲染损坏、摘要缺失等真实用户会遇到的缺陷。它不是脚本,而是一份测试协议,规定测试对象、顺序、判定标准与报告内容。

调用方式:需传入宿主参数 claude 或 codex;缺失或有歧义时应先简短询问,不可猜测。Claude 侧公开斜杠命令为 /circuit:run 与 /circuit:handoff,内置流程(build、explore、fix、prototype、pursue、review)经由 Run 路由,以编译镜像形式位于 plugins/claude/skills/<flow>/。Codex 侧公开命令/技能为 run 与 handoff,流程镜像位于 plugins/codex/flows/<flow>/。

执行模式:原生(宿主与目标一致)可用真实命令;跨宿主执行时斜杠命令无效,只能降级为 CLI 加清单检查,并须在报告中标明限制。

环境要求:改动文件的流程会变更工作区,须先建立隔离的临时仓库,并提供带 verify/test/check/lint 脚本的桩 package.json,以便验证步骤有可执行目标。报告与各次运行证据应保存在临时仓库之外,默认位于 $HOME/circuit-surface-test/<timestamp>,可通过 --keep-report-at 或 CIRCUIT_SURFACE_TEST_REPORT_ROOT 指定。

流程:先刷新源码清单,阅读对应宿主的检查清单,搭建环境并做 CLI 自检,然后按其规定顺序执行检查清单,逐项判为 pass、pass-with-finding、fail、skipped 或 partial-skip;清单完成后进行探索性测试,再做一次本地协议冒烟测试,最后按模板写报告并打印终端摘要。清单阶段不应停下来修复问题,A0 结构性冒烟例外。

报告须包含按严重度排序的发现、每项的可复现步骤、来源支撑的清单以及通过率。

限制:本资料未完整给出检查清单细节、具体命令参数、收费与适用平台信息;文档存在截断,部分内容暂未提供。