ccoalm/ccl-skills / skills/platform-observability
platform-observability
VerifiedUse when designing, reviewing, debugging, or shipping observability — service logs, metrics, distributed tracing, log/trace correlation, 给接口·服务加结构化日志与 trace 透传, dashboards, alerts, on-call routing(值班/排班 SOP、P0/P1 打断;发布值班/回滚除外), SLI/SLO, error budgets, 线上是否已启用(开关·配置在生产的实际生效状态)— for a backend product. Owns the cross-cutting evidence layer — what signals must exist, what fields must propagate, what middleware must auto-wire, what verification proves a change is observable in production. Hand off mesh/routing/mTLS to `platform-service-connectivity`, release gates and rollback evidence to `platform-release-engineering`, service-internal architecture (HTTP/RPC/DB/queue) to `software-architecture`. Product-agnostic.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 35.8 KB |
| agents/openai.yaml | config | 282 B |
| references/alerting-and-on-call.md | markdown | 4.4 KB |
| references/framework-middleware-checklist.md | markdown | 18.9 KB |
| references/infra-component-deployment.md | markdown | 13.6 KB |
| references/log-correlation-recipe.md | markdown | 9.8 KB |
| references/log-schema-canonical.md | markdown | 8.0 KB |
| references/metrics-conventions.md | markdown | 12.4 KB |
| references/obs-stack-architecture.md | markdown | 9.4 KB |
| references/sli-slo-design.md | markdown | 6.4 KB |
| references/source-register.md | markdown | 1.7 KB |
references/source-register.md
View on GitHub# platform-observability — impact-chain / owner map
Upstream-owner decision-surface changes record their downstream owners here
(`upstream rule | downstream owner | expected executable behavior | status | evidence`).
| upstream rule (this skill) | downstream / sibling owner | expected behavior there | status | evidence |
|---|---|---|---|---|
| R1 propagation trust boundary; Baggage carries non-authoritative context only; `lane`/routing derived from authenticated identity | `platform-service-connectivity` | mesh/gateway derives lane from identity; routing keys not trusted from inbound Baggage | routed (its domain) | W3C Baggage security note; OTel docs |
| Phase C: non-mesh collector + STRICT mTLS conflict → exception required | `platform-service-connectivity` | owns the mTLS exception YAML (sidecar/ambient PeerAuthentication/DestinationRule); obs only requires it be declared | routed | Istio PeerAuthentication docs |
| R8 SLI = good/valid events ratio; latency = threshold-bucket ratio | `platform-release-engineering` | error-budget release gate consumes these SLIs | unchanged (already references R8) | Google SRE Workbook |
| R3 instance-identity not a metric label; instrument discipline | `go-microservice-architecture` / `python-service-architecture` | language-agnostic rule; no stack-specific glue needed | unchanged | Prometheus / OTel Metrics docs |
| R8 burn-rate tiers aligned to Workbook Table 5-6 (long+short AND windows; 3d slow tier replaces 24h) | `platform-release-engineering` | promotion gate still consumes SLI burn-rate queries unchanged — window/threshold values are obs-owned inputs, gate shape untouched | unchanged | sre.google/workbook/alerting-on-slos (Table 5-6; short window ≈ 1/12 long) |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |