SuperAPI AI 工具集

testing-assistant

测试与质量

查看项目

更新于 10-16 02:56

技能介绍

Testing Assistant 是一个用于测试和验证 Claude Patent Creator 的专家系统技能,定位为管理与测试、验证和质量保证相关的完整测试生命周期,包括单元测试、集成测试、验证与质量保证。

【用途】 该技能用于运行测试套件、验证新功能、在代码变更后执行测试、调试测试失败、创建新测试、配置 CI/CD、进行性能测试、端到端验证以及回归测试。其面向的测试对象是 Claude Patent Creator 项目。

【主要能力】 根据资料,该技能提供以下测试脚本,均位于 scripts/ 目录:

  • test_install.py:完整安装验证
  • test_gpu.py:GPU 检测与 CUDA
  • test_bigquery.py:BigQuery 连接测试
  • test_analyzers.py:权利要求、说明书、形式审查分析器测试
  • test_embedding_speed.py:性能基准测试
  • test_checkpoint.py:索引检查点系统测试

同时支持通过 Claude Code 界面手动测试 MCP 工具,示例包括:让 Claude 检索 MPEP、检索专利、审查权利要求、运行 /full-review 命令、生成图表并验证所有工具可用。资料还给出快速测试示例:MPEP 检索(如“Search MPEP for claim definiteness requirements”)、专利检索(如“Search for patents about neural networks filed in 2024”)、权利要求审查(粘贴测试权利要求)、完整审查(/full-review)以及流程图生成。

【测试策略】 技能采用测试金字塔策略:更多单元测试(快速、隔离),较少集成测试(中等),最少量的端到端测试(较慢)。资料给出的验证清单包括:MPEP 检索返回相关结果、BigQuery 检索可找到专利、权利要求分析器能识别问题、说明书分析器检查支持、形式检查器验证格式、图表成功生成、完整审查工作流完成、所有 MCP 工具可访问、错误信息清晰有用、性能可接受(多数操作小于 2 秒)。

【使用方式】 资料说明:测试脚本位于 scripts/ 目录;需从项目根目录运行;测试需要激活的 venv;仅在测试失败时运行诊断。快速运行命令为 python scripts/test_install.py。资料还给出回归测试命令序列,例如依次运行 test_install.py、test_bigquery.py、test_analyzers.py,任一步骤失败即退出,并在最后输出全部回归测试通过。资料还提供了创建新测试的单元测试模板,包含从 mcp_server.your_module 导入类、实例化、调用方法并断言的示例代码。测试类别包括基本功能、边界情况、性能和错误处理。

【性能测试】 资料给出一个快速基准示例:从 mcp_server.mpep_search 导入 MPEPIndex,构建索引并执行一次搜索预热,随后对“claim definiteness”执行 top_k=5 搜索并计时。性能阈值表如下:MPEP 搜索(首次)小于 3 秒(模型加载);MPEP 搜索(后续)小于 500 毫秒(缓存模型);BigQuery 搜索小于 2 秒(依赖网络);权利要求分析小于 3 秒(20 条权利要求);说明书分析小于 10 秒(10 页);图表生成小于 1 秒(SVG 输出)。

【故障排查】 资料列出常见问题及解决方案:导入错误时激活 venv 并执行 pip install -r requirements.txt;GPU 测试失败时检查 nvidia-smi、重装 PyTorch 或跳过;BigQuery 失败时重新执行 gcloud auth application-default login;索引未找到时运行 patent-creator rebuild-index;速度过慢时检查 GPU 使用、首次运行较慢及系统负载。

【最佳实践】 资料建议:每次变更后测试、自动化测试、遵循测试金字塔(更多单元、更少端到端)、测试套件快速(少于 5 分钟)、测试隔离(无依赖)、断言清晰、编写测试文档、测试纳入版本控制、定期执行(每周)、监控性能。

【适用场景】 适合在 Claude Patent Creator 开发与维护过程中执行安装验证、GPU/CUDA 检测、BigQuery 连接检查、分析器验证、性能基准、索引检查点验证、回归测试、CI/CD 集成以及通过 Claude Code 进行的手动端到端测试。

【限制】 资料未提供该技能的具体收费方式、价格、平台支持范围或效果保证。技能要求从项目根目录运行且需要激活的 venv;部分测试(如 BigQuery、GPU)依赖外部环境或硬件;性能阈值中部分指标依赖网络或系统负载。