name: metric-log description: 分析 Java 代码，识别业务指标项并提供监控建议。触发词: "指标日志"、"metric log"、"业务指标"、"指标识别"。

Metric Log Skill

分析 Java 业务代码，识别可监控的指标项，提供指标定义和采集建议。

触发

• 用户请求: "业务指标"、"metric log"、"指标识别"、"添加监控"
• 文件: **/*Service.java, **/*Controller.java, **/*Manager.java, **/*Facade.java

核心思路

本 skill 不预设具体业务领域的指标，而是基于代码模式识别指标特征，由用户根据业务定义具体指标名。

执行步骤

1. 读取用户提供分析的文件

   • 解析类名（推断业务领域）
   • 扫描所有 public 方法

2. 询问用户

   是否需要扫描项目中的 AOP 类？（可选）

   • 是：扫描项目中已有的 Aspect/Interceptor/Filter，作为补充参考
   • 否：仅分析用户提供的文件

3. 指标识别与分析

   • 根据方法名前缀推断操作类型
   • 根据返回类型推断结果指标
   • 根据参数类型推断维度标签
   • 扫描异常处理块
   • 扫描耗时计算点
   • 如有 AOP：结合 AOP 分析已有的采集情况

4. 生成识别报告（统一输出格式）

   • 按方法列出识别依据
   • 提供建议的指标名模板
   • 标注建议的标签
   • 如有 AOP：标注已有的采集情况

通用识别模式

1. 方法命名识别 (CRUD + 业务动作)

方法名是识别指标的最重要线索：

业务动作识别：

// 识别: 方法名包含 create/add/save → 增量计数器
public User createUser(UserRequest request) { } → 建议指标: xxx_created_total

// 识别: 方法名包含 pay/refund → 交易类指标
public PayResult pay(PayRequest request) { } → 建议指标: xxx_pay_total + xxx_pay_amount

// 识别: 方法名包含 login → 登录类指标
public LoginResult login(String username) { } → 建议指标: login_attempts_total

// 识别: 方法名包含 get/find/query → 查询类指标
public Order getOrder(Long id) { } → 建议指标: xxx_query_total + xxx_query_duration_ms

2. 参数特征识别

根据参数类型推断指标：

// 识别: 分页参数 → 分页指标
public Page<Order> listOrders(Pageable pageable) {
    // 建议添加标签: page, size
}

// 识别: 批量参数 → 批量大小指标
public void batchImport(List<ImportData> dataList) {
    // 建议指标: batch_size (记录 dataList.size())
}

// 识别: 金额参数 → 金额类指标
public void charge(BigDecimal amount) {
    // 建议指标: xxx_amount_total (Sum)
}

3.