1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | quarkus-application-development-github-awesome-copilot |
| 作者/维护者 | GitHub(github/awesome-copilot 合集);该技能由社区贡献者 Julien Dubois 于 2026-10 提交,并经评审意见多轮修订 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/quarkus-application-development |
| 许可证 | MIT(合集仓库,GitHub API) |
| GitHub Stars / Forks | 合集整体 40,167 / 5,155(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | 技能刚发布,第三方安装榜尚无独立数据 |
| 最新版本 | 无独立版本号;最近一次提交 2026-10-15 |
| 安装方式 | 复制目录到 agent 的 skills 目录,或 gh skills install github/awesome-copilot quarkus-application-development |
2. 功能介绍与亮点
这是一份面向 AI 编程助手的 Quarkus 应用开发指南,范围限定在“已有 Quarkus 项目里写业务代码”。主文件 + 6 份参考文档,合计约 30 KB。
- Agent 行为规则:先读
pom.xml/build.gradle识别平台版本与已有扩展,沿用项目现状;加扩展一律用quarkus extension add,不手写坐标;Kafka、OIDC 等会拉起容器的基础设施依赖须先问用户;禁止在项目未使用时引入 Spring 兼容扩展;不得硬编码密钥。 - 速查决策表:JSON REST、类型化配置、CDI 作用域、Panache 持久化、命令式与响应式取舍、Kafka 消息、OIDC 鉴权、健康/指标/OpenTelemetry、容错、REST Client、定时与缓存,每项给出推荐扩展和对应参考文档。
- 踩坑清单:CDI 构建期裁剪未使用 Bean、对
@ApplicationScopedBean 读公共字段会命中客户端代理、事件循环上不能阻塞、构建期属性改动需重建、%dev/%test里配外部 URL 会关掉 Dev Services、drop-and-create仅限开发测试。 - 实测痕迹:文中标注在 Quarkus 3.40.1 与 3.27.6(Java 21、Maven)上用脚手架应用跑通 15 个测试,覆盖 REST+校验、OpenAPI、Panache+PostgreSQL Dev Services、Kafka、Keycloak 等。
3. 适用场景
分类:工程效率与代码质量。
- 让 AI 助手在现有 Quarkus 项目里加接口、数据库访问、消息消费、鉴权与可观测性。
- 从 Spring Boot 转 Quarkus 的 Java 开发者,借“踩坑清单”避开 CDI 与响应式的常见陷阱。
- 受益人群:使用 Copilot / Claude Code 等助手做 Java 后端的初中级开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(front matter + 正文 + references),复制到 ~/.claude/skills/ 即可 |
| Codex | 需适配 | 同为 SKILL.md 格式,但不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未取得实际加载证据 |
| Hermes Agent | 原生支持(按路径) | 按路径扫描子目录探测 SKILL.md;未实机安装 |
5. 推荐理由
Quarkus 的构建期 CDI、Dev Services、响应式线程模型和 Spring 差异很大,通用 Java 提示词容易生成“能编译但行为不对”的代码。该技能把检测项目现状、不乱猜依赖、先问再装基础设施写成硬规则,并给出实测过的配置,能直接减少返工。纯文档技能,无脚本、无外联。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 贡献者个人提交,刚发布数日,尚无独立装机数据与具名评价;合集的 40,167 stars 不计入本技能 |
| 可用性 | 9 | 复制即用,无需配置;主文件 + 6 份参考文档完整,含实测版本;近一周内持续修订 |
| 安全性 | 9 | 见下方检查清单 |
综合 = 三项均值 = 7.67。
安全检查清单:
- 执行 shell:技能本身不含脚本;指令里出现的
quarkus/mvnw命令由用户的 agent 在用户项目中执行,用途明确。通过。 - 联网外发:无外发;仅引用官方文档链接。通过。
- 凭据:明确要求密钥走环境变量/密钥库,不写入
application.properties。通过。 - 可疑指令:通读主文件与参考文档,无提示注入迹象;引入 Kafka/OIDC 前要求先问用户。通过。
- 作者/组织信誉:GitHub 官方合集;贡献者为长期 Java 社区成员。通过。
- License:MIT。通过。
- 维护:2026-10-15 仍在提交。通过。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| 本技能 | Quarkus 应用代码开发 | 专讲 Quarkus 特有机制,含 agent 行为约束与踩坑 |
| java-springboot(同合集) | Spring Boot 开发规范 | 面向 Spring 生态,不覆盖 Quarkus 的构建期 CDI、Dev Services |
| Quarkus 官方指南(quarkus.io/guides) | 人读文档 | 覆盖最全,但不是为 agent 裁剪的操作规则 |
| 通用 Java 编码提示词 | 语言层最佳实践 | 不涉及框架扩展、配置 profile 与 Dev Services |
核心差异:规则与踩坑直接针对 Quarkus,并带实测版本标注。
8. 用户评价
该技能发布时间很短,目前在第三方平台尚无具名用户评价。
9. 其他补充
同一作者在合集中提供配套技能:项目创建(create-quarkus-project)、Dev Services 与测试(quarkus-dev-services-and-testing)、原生与容器镜像(quarkus-native-and-container),本技能明确与它们划清边界。
10. 安装使用方式
# 方式一:gh 安装
gh skills install github/awesome-copilot quarkus-application-development
# 方式二:手动复制
git clone https://github.com/github/awesome-copilot
cp -r awesome-copilot/skills/quarkus-application-development ~/.claude/skills/
安装后在含 Quarkus 项目的目录里让助手“给这个 Quarkus 服务加 Panache 持久化”之类的请求,即会按描述自动触发;一般无需重启,必要时新开会话。
11. 注意事项
- 技能新发布,建议先在小项目验证其中配置键名是否与自己的 Quarkus 版本一致(文中自己也提示“按项目版本复核名称”)。
- Dev Services 依赖本机 Docker/Podman,Keycloak 首次启动较慢(文中实测约 50 秒)。
- 范围仅限应用代码;创建项目、测试、原生镜像需配套技能或另行处理。
- 部分建议(如默认拒绝未注解端点)文中标明未实测。