用途:统一处理 ddd4j-boot 的 Actuator、存活/就绪探针、指标、追踪、日志、监控与 OpenTelemetry 集成,而非按 Maven 构件拆分。使用前需通过 ddd4j-boot-version-selection 确认维护线。
主要能力:配置 Actuator 暴露并区分存活与就绪探针(就绪聚合真实依赖检查);接通指标与 ddd4j 指标桥,使领域与框架计数器真正递增;用 OpenTelemetry 建立追踪并验证 collector/exporter 确实收到 span;决定日志格式与关联(日志中的 trace ID);审查 exporter 生命周期(须有明确 owner、失败回滚、幂等 close);诊断“已配置但无数据”问题。
使用方式:先确认目标维护线的 POM、源码与测试证据,定位该线上的 Actuator、monitor、metrics、OpenTelemetry 自动配置与属性;设计可观测性集合;检查条件装配、默认 bean 与用户覆盖点,确认关闭开关真正跳过装配;执行上下文测试与行为测试(依赖故障下的探针响应、真实操作下的指标递增、在 collector/后端而非仅 SDK 边界验证导出);报告时分别列出配置存在、bean 创建、行为、CI 与发布证据。
适用场景:ddd4j-boot 项目的可观测性实现选型与 Spring Boot 装配、配置覆盖与生命周期验证、维护线兼容性判断。
限制:不用于设计指标名或指标 SPI 契约(用 ddd4j-metrics)、就绪端点 HTTP 契约或 Web 层错误契约(用 ddd4j-boot-web)、通用自动配置机制(用 ddd4j-boot-autoconfiguration);运行时为 Quarkus、Javalin 或 Spring Cloud 时改用对应技能;纯 Spring Boot 无 ddd4j 时用通用技能;不修改 ddd4j 核心公共语义,不以依赖或 bean 存在替代真实行为,不自动扩展为发布或生产运维。信息缺失时输出“missing: target line/implementation/configuration; how to provide: supply the POM and acceptance behavior”,并继续只读检查。安装示例:npx skills add full-stack-skills/ddd4j-skills --skill ddd4j-metrics。