1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | quarkus-native-and-container-github-awesome-copilot |
| 作者/维护者 | GitHub(github/awesome-copilot 合集);该技能由社区贡献者 Julien Dubois(Microsoft Java 开发者倡导者)于 2026-10 提交,2026-10-15 经维护者评审合入 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/quarkus-native-and-container |
| 许可证 | MIT(合集仓库,GitHub API) |
| GitHub Stars / Forks | 合集整体 40,217 / 5,163(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | 技能刚发布,第三方安装榜尚无独立数据 |
| 最新版本 | 无独立版本号;最近一次提交 2026-10-15 |
| 安装方式 | 复制目录到 agent 的 skills 目录,或 gh skills install github/awesome-copilot quarkus-native-and-container |
2. 功能介绍与亮点
面向 AI 编程助手的 Quarkus 原生可执行文件与容器化指南,单个 SKILL.md 约 9 KB,无脚本。
- 原生构建:容器构建(无需本地 GraalVM)与本地 Mandrel 两条路径,Maven 与 Gradle 命令齐备,并标注
quarkus.package.type在 3.10 后被quarkus.native.enabled取代的版本分界。 - 常见原生失败速查表:反射类找不到、资源文件缺失、构建期初始化出错、构建内存不足,各给出对应配置键。
- 原生二进制测试:用
@QuarkusIntegrationTest配合verify阶段;指出 macOS/Windows 容器构建出的是 Linux 二进制,集成测试会以 126 退出。 - 镜像与部署清单:Jib/Docker 镜像扩展、
src/main/docker下的 Dockerfile 变体、Kubernetes 与 OpenShift 清单生成及探针行为。 - 实测痕迹:文中标注在 Quarkus 3.40.1 与 3.27.6 上实际构建、复现并修复了上述失败。
3. 适用场景
分类:DevOps 与基础设施。
- 把 Quarkus 服务编译成原生二进制,并排查反射/初始化导致的原生构建失败。
- 为 Quarkus 项目生成容器镜像和 Kubernetes/OpenShift 部署清单。
- 受益人群:用 Copilot / Claude Code 等助手做 Java 后端交付的初中级开发者与运维。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(front matter + 正文),复制到 ~/.claude/skills/ 即可 |
| Codex | 需适配 | 同为 SKILL.md 格式,但不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未取得实际加载证据 |
| Hermes Agent | 原生支持(按路径) | 按路径扫描子目录探测 SKILL.md;未实机安装 |
5. 推荐理由
原生构建失败往往要在几分钟的编译后才暴露,且报错与框架版本强相关。该技能把版本分界、失败症状到配置键的对应、跨平台二进制陷阱写成可直接照做的清单,并给出复现过的实测结果,能减少反复试错。纯文档技能,无脚本、无外联。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 贡献者个人提交,刚发布数日,尚无独立装机数据与具名评价;合集的 40,217 stars 不计入本技能 |
| 可用性 | 9 | 复制即用,无需配置;命令完整、含版本分界与实测说明;近一周内持续修订 |
| 安全性 | 9 | 见下方检查清单 |
综合 = 三项均值 = 7.67。
安全检查清单:
- 执行 shell:技能本身不含脚本;文中的
mvnw/gradlew/docker/kubectl命令由用户的 agent 在用户项目中执行,用途明确。通过。 - 联网外发:无外发;构建会拉取 Mandrel 构建镜像,属 Quarkus 官方流程,文中已说明。通过。
- 凭据:要求密钥走 Kubernetes Secret 与环境变量,并提示“生成的 YAML 应先审阅、不要把密钥写入”。通过。
- 可疑指令:通读全文无提示注入迹象。通过。
- 作者/组织信誉:GitHub 官方合集;贡献者为长期 Java 社区成员。通过。
- License:MIT。通过。
- 维护:2026-10-15 仍在提交。通过。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| 本技能 | Quarkus 原生构建与容器化 | 针对 Quarkus 的 Mandrel 版本匹配、反射注册与 Quarkus 扩展生成清单 |
| java-add-graalvm-native-image-support(同合集) | 通用 Java 项目接入 GraalVM Native Image | 框架中立,不涉及 Quarkus 扩展与其版本门槛 |
| Quarkus 官方指南(quarkus.io/guides) | 人读文档 | 覆盖最全,但不是为 agent 裁剪的操作清单 |
| 通用 Dockerfile / Kubernetes 提示词 | 容器与编排通用实践 | 不涉及原生镜像构建与 Quarkus 的清单生成属性 |
核心差异:以 Quarkus 版本为轴的原生构建与排错清单,带实测版本标注。
8. 用户评价
该技能发布时间很短,目前在第三方平台尚无具名用户评价。其提交 PR 经 CI 风险扫描与 Lint 全部通过,并由合集维护者评审后合入。
9. 其他补充
同一作者在合集中提供配套技能:项目创建(create-quarkus-project)、应用开发(quarkus-application-development)、Dev Services 与测试(quarkus-dev-services-and-testing),本技能与它们划清边界。
10. 安装使用方式
# 方式一:gh 安装
gh skills install github/awesome-copilot quarkus-native-and-container
# 方式二:手动复制
git clone https://github.com/github/awesome-copilot
cp -r awesome-copilot/skills/quarkus-native-and-container ~/.claude/skills/
安装后在 Quarkus 项目里让助手“构建原生可执行文件”或“生成容器镜像和 Kubernetes 清单”即会触发;一般无需重启,必要时新开会话。
11. 注意事项
- 原生构建耗时长、占内存大(文中提示数 GB),建议放在 CI 或按需执行。
- 容器构建需本机 Docker/Podman;Mandrel 版本须与 Quarkus 版本匹配。
- 技能新发布,文中配置键名请按自己的 Quarkus 版本复核。
- 仅覆盖 Quarkus;其他框架的 GraalVM 接入需另行处理。