Skills · Claude Code · Agent Skills
看不见的系统就无法运维 — 没有商量余地。
使用带 Collector 的 OpenTelemetry，让追踪、指标与日志相互关联，用 burn-rate 管理 SLO，让告警指向 runbook。可观测性与服务同时诞生，而不是事后补。
schematize-observability · v0.2.1bash
$ schematize install observability不可妥协的底线
绝不为“求快”而关闭。完整清单见技能。
OpenTelemetry 与 Collector
SDK 通过 OTLP 与 Collector 通信，绝不直连后端；服务代码中禁止使用厂商 SDK。
与服务同时诞生
只有输出结构化日志、指标和追踪，提供探针，并随版本化的仪表盘、告警和 SLO 一起发布的服务才算完成。
每条日志都可关联
每条 JSON 日志带 trace_id 与 span_id，消息保持固定、数据放在属性里，Resource 带 deployment.environment.name。
遥测中没有 PII 与密钥
在源头脱敏，并在 Collector 中使用 redaction；user_id、邮箱和 IP 绝不作为指标标签。
采样绝不丢失错误
通过 tail sampling 保留 100% 的错误或慢追踪；RED 指标不从采样后的追踪推导。
每个服务都有 SLO
基于 error budget 的多窗口 burn-rate，预算耗尽即冻结新功能。
告警反映症状，并附 runbook
针对用户症状的告警带 severity、for 和 runbook_url；无人处理的告警直接删除。
环境隔离
dev 与 hml 的遥测绝不进入 prd 后端，hml 不会在半夜叫醒任何人。
命令
安装在 .claude/commands/。随时运行 /obs-help。
/obs-alerts审计或编写告警（用户症状、severity、for、runbook），并运行 check-alertas.mjs。/obs-ccContext compact：将上下文和清单写入归档并运行 /compact。/obs-claude在仓库根目录创建或合并常开的 observability CLAUDE.md（不覆盖其他技能的区块）。/obs-dashboard仪表盘即代码（SLO、RED、USE 与链接）。/obs-handoff生成上下文交接而不压缩——会话结束或任务切换。/obs-help列出所有命令。/obs-instrument按标准为服务埋点（SDK 到 Collector、semconv、JSON 日志、健康检查），使用清单内的语言。/obs-load强制加载全部规范内容并开始应用。/obs-review审查服务的可观测性（信号、关联、PII、基数、探针、SLO）并运行门禁。/obs-slo在 /docs/slo.md 中定义 SLI、SLO 与 error budget，并生成 burn-rate 规则。面向 AI 智能体
无需人工即可安装。元数据见 llms.txt。
- 运行：git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
- 或下载：https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip 并解压到 .claude/skills/
- 将 assets/CLAUDE.md 复制到仓库根目录（常开规则）。
- 用 /obs-help 确认。
讨论
加载中…