关于 703-technologies-fuzzing-testing
使用 CATS 和 OpenAPI 对 Java HTTP API 进行契约驱动模糊测试的技能。它指导开发者开展负向与边界测试、设置本地及 CI 工作流并处理发现的问题,同时强调可信工具和构建验证。
主要功能
- 01配置 CATS 进行 OpenAPI 模糊测试
- 02针对无效及格式错误输入的负向测试
- 03检查大小、范围和格式边界
- 04本地与 CI 工作流指引
- 05发现问题的报告与分类处理
适用场景
- 01依据 OpenAPI 契约对 Java API 进行模糊测试
- 02在 CI 中加入格式错误输入检查
- 03测试 API 边界和枚举约束
- 04复现并分类处理模糊测试发现
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jabrena/ plinth --skill 703-technologies-fuzzing-testing安装后在 Claude Code 中输入/703-technologies-fuzzing-testing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/cats.dockerfilereferences/703-technologies-fuzzing-testing.mdscripts/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 模糊测试
工作流
- 阅读参考文档并评估项目上下文
阅读 references/703-technologies-fuzzing-testing.md,并在提出更改前检查现有 API/上下文产物。
- 收集范围信息并确定目标改进项
确定所需结果、约束,以及要应用的最小安全更改集。
- 应用与技术相符的更改
遵循参考模式和项目约定,实施或重构相关产物。
- 运行验证并报告结果
执行适当的检查,并总结更改内容、已验证事项和后续操作。
参考
如需详细指南、示例和约束,请参阅 references/703-technologies-fuzzing-testing.md。
评论
支持 Markdown