1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | quarkus-dev-services-and-testing-github-awesome-copilot |
| 作者/维护者 | GitHub(github/awesome-copilot 合集);该技能由 Microsoft/GitHub 开发者关系团队成员 Julien Dubois(jdubois)以个人身份提交,2026-10-15 经维护者评审后合入 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/quarkus-dev-services-and-testing |
| 许可证 | MIT(合集仓库,GitHub API) |
| GitHub Stars / Forks | 合集整体 40,246 / 5,170(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | 第三方安装榜尚无独立数据 |
| 最新版本 | 无独立版本号;最近一次提交 2026-10-15 |
| 安装方式 | 复制目录到 agent 的 skills 目录,或 gh skills install github/awesome-copilot quarkus-dev-services-and-testing |
2. 功能介绍与亮点
面向 AI 编程助手的 Quarkus 测试指南:单文件 SKILL.md 约 5 KB,无脚本,聚焦 Quarkus 自有的测试机制,框架中立的 Testcontainers 用法不在其内。
- Dev Services:开发与测试模式下按扩展自动拉起 PostgreSQL、MySQL、Kafka、Redis、Keycloak 等容器;给出全局开关、镜像、容器复用(含
testcontainers.reuse.enable=true前置条件)、固定端口、跨应用共享等配置,以及单项关闭的方法。 - 测试写法:
@QuarkusTest、@InjectMock、@TestSecurity、@TestProfile、@TestTransaction、@QuarkusIntegrationTest的用途与限制(集成测试里不能注入 Bean,只能走 HTTP)。 - 测试资源:
QuarkusTestResourceLifecycleManager配合@WithTestResource,说明与旧注解@QuarkusTestResource的作用域差异,以及测试类里不要注入由测试资源提供的@ConfigProperty。 - 踩坑提示:
*IT由 Failsafe 在verify阶段执行,./mvnw test会静默跳过;3.27 与 3.40 模板默认skipITs=true,需加-DskipITs=false;macOS/Windows 上容器构建的 Linux 二进制会让原生集成测试以 126 退出。 - 版本标注:文中声明在 Quarkus 3.40.1(JDK 26、Docker Desktop)上实测过上述用法,3.27.6 上验证了
@QuarkusTest与 Dev Services;同时区分quarkus-junit与旧名quarkus-junit5。 - 持续测试:
quarkus:dev中按r启动/重跑、p暂停,以及quarkus.test.continuous-testing三种取值。
3. 适用场景
分类:工程效率与代码质量。
- 为 Quarkus 项目补写或修复
@QuarkusTest集成测试,不用手写数据库、Kafka 的容器配置。 - 排查“测试在本地没跑”“
verify没执行 IT”“换了测试资源后应用反复重启”等 Quarkus 特有问题。 - 在 CI 中区分单元测试与
@QuarkusIntegrationTest的运行方式。 - 受益人群:使用 Quarkus 的 Java 后端开发者,尤其是刚接触 Dev Services 与 Failsafe 约定的初中级开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(front matter + 正文),复制到 ~/.claude/skills/ 即可 |
| Codex | 需适配 | 同为 SKILL.md 格式,但不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未取得实际加载证据 |
| Hermes Agent | 原生支持(按路径) | 按路径扫描子目录探测 SKILL.md;未实机安装 |
5. 推荐理由
Quarkus 的测试行为有不少与版本相关、模型凭记忆容易写错的细节:quarkus-junit 与 quarkus-junit5 的取舍、@WithTestResource 与旧注解的作用域差异、Failsafe 默认跳过 IT。该技能把这些细节连同实测版本一起固化,并明确“先用 Dev Services,再考虑自定义资源”的优先级,能减少助手生成过时或不可运行的测试代码。体量小(约 5 KB),加载成本低,纯文档无外联。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 开发者个人提交,2026-10 才合入,第三方平台尚无独立装机数据与具名评价;合集的 40,246 stars 属整个仓库,不计入本技能 |
| 可用性 | 9 | 复制即用,无需配置;示例完整,含运行命令与版本说明;合入前经多轮评审修订,合集持续维护 |
| 安全性 | 9 | 见下方检查清单 |
综合 = 三项均值 = 7.67。
安全检查清单:
- 执行 shell:技能本身不含脚本;文中给出
./mvnw test、./mvnw verify等由用户项目执行的构建命令,范围明确。通过。 - 联网外发:无;仅提及 Dev Services 会在本机拉取容器镜像(需 Docker/Podman)。通过。
- 凭据:不涉及。通过。
- 可疑指令:通读 SKILL.md,无提示注入迹象;对其他技能的引用均写明“已安装才用”并给出官方文档兜底。通过。
- 作者/组织信誉:GitHub 官方合集;作者为 JHipster 项目负责人、Microsoft 开发者关系负责人,账号注册于 2010 年;PR 经维护者审阅通过。通过。
- License:MIT。通过。
- 维护时间:2026-10-15,近期。通过。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| 本技能 | Quarkus 的 Dev Services 与测试机制 | 针对 Quarkus 注解、模板默认值与 Failsafe 行为,带 3.27/3.40 实测标注 |
| java-testcontainers(同合集) | 框架中立的 Testcontainers 用法 | 不涉及 Quarkus 的零配置 Dev Services、@QuarkusTest 与测试资源生命周期 |
| Quarkus 官方指南(quarkus.io/guides) | 人读文档 | 覆盖最全,但不是为 agent 裁剪的清单,版本差异需自行比对 |
| 通用 JUnit/Mockito 测试技能 | 通用单元测试写法 | 不处理 Quarkus 应用启动、容器自动拉起与 @InjectMock 的 CDI 语义 |
核心差异:只讲 Quarkus 特有的测试与 Dev Services 行为,并标注已实测的版本。
8. 用户评价
合集维护者 aaronpowell 在该技能所在 PR 的评审中批准合入,称其“版本相关的坑正是模型容易写错的”(来源:github/awesome-copilot PR 5082)。目前在第三方平台尚无具名用户评价。
9. 其他补充
同一批提交还包含 Quarkus 应用开发、原生构建与容器化等姊妹技能,互相引用且可单独安装。
10. 安装使用方式
# 方式一:gh 安装
gh skills install github/awesome-copilot quarkus-dev-services-and-testing
# 方式二:手动复制
git clone https://github.com/github/awesome-copilot
cp -r awesome-copilot/skills/quarkus-dev-services-and-testing ~/.claude/skills/
安装后让助手“给这个 Quarkus 接口补一个带数据库的集成测试”即会触发;一般无需重启,必要时新开会话。Dev Services 需要本机有 Docker 或 Podman。
11. 注意事项
- 内容针对 Quarkus 3.27~3.40 验证,使用更早或更新的版本时请以项目实际版本和官方指南为准。
- 它是写法与排障清单,不会替代项目自身的测试策略,也不会自动启动容器。
- 技能新合入,具体配置请结合自家 Quarkus 版本与 CI 环境复核。