Quarkus Core Guidelines 是一套面向 Quarkus 核心开发的技能规范，用于在构建或审查 Quarkus 应用时，按照参考规则和正反代码示例给出建议。
用途 该技能适用于以下场景：审查 Java 代码中的 Quarkus 应用结构与 CDI 使用；为 Quarkus 配置与 Bean 应用最佳实践；改进 CDI 拦截器、事件或编程式注入；添加虚拟线程配置或调整 CDI 生命周期；审查 Quarkus CDI Bean 生命周期与配置。
主要能力 技能覆盖多个核心主题：
- 应用入口：@QuarkusMain 及何时需要自定义 main。
- CDI 作用域：@ApplicationScoped、@Singleton、@Dependent；Bean 消歧使用 @Default、@Alternative、@Named。
- 依赖注入：使用 @Inject 进行构造函数注入。
- 横切关注点：通过 @Interceptor、@InterceptorBinding 实现 CDI 拦截器。
- CDI 事件：@Observes StartupEvent / ShutdownEvent，以及 @ObservesAsync 异步派发。
- 编程式注入：使用 Instance 进行动态 Bean 选择。
- 配置：@ConfigMapping 结合 Bean Validation（@Valid）实现结构化配置。
- 配置档案：使用 %dev、%test、%prod 等档案属性，以及 @IfBuildProfile。
- 生命周期：启动与关闭观察者 @Startup、@PreDestroy。
- 虚拟线程：@RunOnVirtualThread（需要 Java 21+）。
- 原生镜像安全：@RegisterForReflection、@DisabledOnNativeImage。
使用方式 工作流分为四步：第一步阅读参考资料 references/401-frameworks-quarkus-core.md 并检查当前项目设置；第二步明确目标成果、约束和最小安全改动集；第三步按照参考模式与项目约定实现或重构配置与代码；第四步执行构建与测试并汇报结果。
约束与前置条件 应用任何 Quarkus 改动前，必须确保项目可编译：需先运行 ./mvnw compile 或 mvn compile。项目必须成功编译才能应用 Quarkus 核心改进；若编译失败须立即停止，编译错误是阻塞条件，须由用户解决后才能继续。应用改进后需运行 ./mvnw clean verify 或 mvn clean verify 进行验证。在应用改动前应阅读参考文献以获取详细规则、正反模式与约束。
适用场景与限制 该技能面向 Quarkus 核心框架层面的开发与审查，围绕 CDI、配置、生命周期、拦截器、事件与虚拟线程等主题。资料未提供具体收费、价格、支持平台或量化效果信息；技能的具体规则细节需查阅其参考文件 references/401-frameworks-quarkus-core.md。