agent-observability-spec

为代理/LLM功能制定追踪、指标与告警的可观测性规范

为 AI agent 或 LLM 功能定义需要记录的 trace、span、指标和告警规则，告诉你该记录什么、怎么采样、谁负责以及何时报警。用在设计可观测的 LLM 服务、排查行为问题或量化质量与成本时最合适。特别之处是把行为可观测（not 只是可用性）当核心，包含隐私说明和存储保留策略，便于生产环境落地监控。

# Agent Observability Spec Skill

You can't fix what you didn't record. For LLM systems the unit of observability is the *trace* — everything the model saw and did — because behaviour, not uptime, is what fails. This skill specifies what to capture, what to compute from it, and when to page someone.

## What This Skill Produces

- A **trace schema**: per-request spans and the fields each must carry
- **Metric definitions** across health, quality, cost, and behaviour — each with a threshold and owner
- A **sampling and retention policy** that keeps cost sane and debugging possible
- A **privacy note**: what logged content contains, who can see it, and how long it lives

## Required Inputs

As