用途：本技能面向 cmux-team 的度量分析，通过 CLI「cmux-team metrics query --sql '<SQL>'」运行 DuckDB（0.10+）ad-hoc SQL，做跨 task 聚合、时序趋势、cohort 比较与干预评估。若只关心单个 task 的 session 历史，应使用 trace-task 技能；本技能用于「多个 task 之间发生了什么」。
可用数据源：t.api_usage、t.hook_signals、t.task_sessions、t.rate_limit_snapshots 来自 traces.db（只读挂载）；events 视图来自 events.jsonl；snapshots 与 snapshots_per_task 视图来自 snapshots/*.json。缺失数据源会在 stderr 警告并静默跳过。hook_signals 无 task_id，需先用 MIN(task_id) GROUP BY session_id 关联 task_sessions。
主要能力：附带 recipe 库，含 per-task token 汇总、baseline 与 evaluation 的 cohort 抽取、forced_close 前 hook_signals 溯源、同 session 内 tool_failure 连查、SESSION_STARTED 的 loadedPlugins/loadedSkills cohort 过滤、per-day outcome 趋势等。统计检验可配合 cmux-team metrics compare。
使用方式：把 recipe 的 SQL 直接传入 metrics query；用 --format 选择 table、json、csv、tsv；用 --explain 查看查询计划。
限制：查询务必用时间范围过滤，避免全表扫描；DuckDB 为只读挂载，用户 SQL 中不要重复 ATTACH/INSTALL/LOAD；解析 JSON 前需 json_valid 跳过畸形 payload；plugin_state 为 unknown 的 session 不应并入无插件 cohort。claim-vs-diff 检测、duration 异常筛选、rate-limit 与 forced_close 相关性目前仅为候选，暂未提供实现。