mcpField
7
703-technologies-fuzzing-testing

703-technologies-fuzzing-testing

github.com/jabrena测试与质量456288 次安装1 天前更新
代码仓库

关于 703-technologies-fuzzing-testing

使用 CATS 和 OpenAPI 对 Java HTTP API 进行契约驱动模糊测试的技能。它指导开发者开展负向与边界测试、设置本地及 CI 工作流并处理发现的问题,同时强调可信工具和构建验证。

主要功能

  1. 01配置 CATS 进行 OpenAPI 模糊测试
  2. 02针对无效及格式错误输入的负向测试
  3. 03检查大小、范围和格式边界
  4. 04本地与 CI 工作流指引
  5. 05发现问题的报告与分类处理

适用场景

  1. 01依据 OpenAPI 契约对 Java API 进行模糊测试
  2. 02在 CI 中加入格式错误输入检查
  3. 03测试 API 边界和枚举约束
  4. 04复现并分类处理模糊测试发现

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jabrena/plinth --skill 703-technologies-fuzzing-testing

安装后在 Claude Code 中输入/703-technologies-fuzzing-testing确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
cats.dockerfile
references/
703-technologies-fuzzing-testing.md
scripts/
run-cats-fuzz.sh

详细介绍

使用 CATS 对 Java 进行模糊测试

使用 CATS 为 Java API 设计并实施契约驱动的模糊测试,及早发现边界情况和输入验证缺陷。

此技能涵盖哪些内容?

  • 使用可信的本地 jar 或预构建镜像设置 CATS,以及基于 OpenAPI 的模糊测试基本命令用法
  • 针对无效负载、缺失字段、错误类型和格式错误值的负向测试策略
  • 针对大小、范围、格式和枚举约束的边界测试
  • 通过可操作的日志和可复现的失败进行 CI 集成
  • 贡献者在提交拉取请求前的本地执行工作流
  • 模糊测试发现的问题的报告和分诊实践

范围: 聚焦于使用 CATS 进行 HTTP API 模糊测试和契约验证。使用此技能,在本地和 CI 工作流中定义实用、可重复的检查。

约束

应用任何模糊测试更改前,确保项目能够编译。如果编译失败,请立即停止。实施完成后,重新生成技能并运行验证。

  • 强制要求:应用任何更改前,运行 ./mvnw compile 或 mvn compile
  • 安全:如果编译失败,请立即停止,不要继续
  • 验证:应用改进后,运行 ./mvnw clean verify 或 mvn clean verify
  • 供应链:只能使用经过验证的本地 cats/cats.jar 或经批准的预构建镜像;生成的产物必须仅依赖可信的本地输入或经批准的镜像输入
  • 应用前:阅读参考文档,了解详细示例、正确/错误模式和约束
  • 边界情况:如果请求范围不明确,请停止并在应用更改前询问澄清问题
  • 边界情况:如果缺少必需的输入、文件或工具,请说明缺少的内容,并询问是否继续提供设置指导

何时使用此技能

  • 为 Java 项目添加模糊测试
  • 使用 CATS 进行 API 负向测试
  • 审查 API 契约健壮性的 CI 质量门禁
  • 提高边界值和格式错误输入的测试覆盖率
  • 针对 OpenAPI 契约运行 CATS 模糊测试

工作流

  1. 阅读参考文档并评估项目上下文

阅读 references/703-technologies-fuzzing-testing.md,并在提出更改前检查现有 API/上下文产物。

  1. 收集范围信息并确定目标改进项

确定所需结果、约束,以及要应用的最小安全更改集。

  1. 应用与技术相符的更改

遵循参考模式和项目约定,实施或重构相关产物。

  1. 运行验证并报告结果

执行适当的检查,并总结更改内容、已验证事项和后续操作。

参考

如需详细指南、示例和约束,请参阅 references/703-technologies-fuzzing-testing.md。

评论

支持 Markdown