用途：集中读取 Claude Code 的可观测性数据，说明各遥测源（OTEL collector、仪表盘、DuckDB 存储）如何配合，并生成跨会话趋势报告。CC 即 Claude Code CLI。该技能只读，除非传入 --write，否则不写入用户可见状态。
主要能力：支持按范围生成报告，第一参数决定行为：session（当前会话）、day（近 24 小时）、week（默认，近 7 天）、month（近 30 天）、since:YYYY-MM-DD（自指定日期）、all（全部历史）。可加第二参数 --write，将报告保存到 ${CLAUDE_PLUGIN_DATA}/reports/claude-observability-<date>.md 而非标准输出。当范围为 week 或更大时，可在 markdown 之外可选输出自包含 HTML 仪表盘。支持 clean 维护动作，参数 [--keep-days N]（默认 30）[--dry-run] [--quiet]，用于清理 JSONL 与 OTEL 存储；模型调用 clean 时需先展示 --dry-run 输出并取得用户确认。
数据来源：ccusage（MCP 或 CLI，提供 token 数、美元成本、计费块）、hook 事件日志（.claude/observability/hook-events.jsonl，含持续时间与退出码）、OTEL 存储（$CC_OTEL_STORE/*.json 经 DuckDB，含日志、指标、span）、自动记忆、Git/GH 活动上下文。按需读取 context/ 下的 read-routing、otel-pipeline、otel-queries、operator-setup、data-sources、output-format、privacy 等文档。
用法：调用 /observability 加范围或动作，例如 /observability week --write 或 /observability clean --dry-run。若 $1 为 clean，则转交 scripts/clean.sh 并返回其退出码；范围不合法时提示使用 session|day|week|month|since:YYYY-MM-DD|all|clean。
限制：不追踪 GitHub 缺陷（用 /known-issues）；不修改代码；不替代内置 /insights 或自有复盘流程；除非用户明确保存，不写入记忆。首次运行时存储为空属正常，应优雅降级。session_id 可能漂移，需用 cwd、分支与时间接近度判断。Stop hook 不可靠，不应依赖其聚合。cc_spans/cc_traces 视图在 cc-traces.json 有内容前会跳过绑定。collector 配置与长驻服务生命周期由机器配置管理。