Programowanie · Budowanie i kod
macos-telemetry
/macos-telemetry
Dodaje lekką telemetrię do aplikacji macOS i sprawdza logi zdarzeń okien, menu i akcji.
Dla kogo
- Autor
- radiumcoders ↗
- Repozytorium
- openusage-linux ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 03.11.2026
Ocena i bezpieczeństwo
100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 03.11.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Dodaje lekką telemetrię do aplikacji macOS i sprawdza logi zdarzeń okien, menu i akcji.
Oryginalny opis (EN)
Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.
Jak działa
- Quick Start
- Core Guidelines
- Minimal Logger Pattern
- Workflow
- Verification Checklist
- Guardrails
Sekcje z nagłówków SKILL.md, w oryginale · 83 linii, 524 słów
Podgląd SKILL.md
---
name: macos-telemetry
description: Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.
---
# Telemetry
## Quick Start
Use this skill to add lightweight app instrumentation that helps debug behavior
without turning the codebase into a logging landfill. Prefer Apple's unified
logging APIs and verify the events after a build/run loop.
## Core Guidelines
- Prefer `Logger` from the `OSLog` framework for structured app logs.
- Give each feature a clear subsystem/category pair so runtime filtering stays easy.
- Log meaningful user and app lifecycle events: window opening, sidebar selection changes, menu commands, menu bar extra actions, sync/load milestones, and unexpected fallback paths.
- Keep info logs concise and stable. Use debug logs for noisy state details.
- Do not log secrets, auth tokens, personal data, or raw document contents.
- Add signposts only when measuring timing or performance spans; do not overinstrument by default.
## Minimal Logger Pattern
```swift
import OSLog
private let logger = Logger(
subsystem: Bundle.main.bundleIdentifier ?? "SampleApp",
category: "Sidebar"
)
@MainActor
func selectItem(_ item: SidebarItem) {
logger.info("Selected sidebar item: \(item.id, privacy: .public)")
selection = item.id
}
```
Use feature-specific categories like `Windowing`, `Commands`, `MenuBar`, `Sidebar`,
`Sync`, or `Import` so logs can be filtered quickly.
## Workflow
1. Identify the behavior that needs observability.
- Window open/close
- Sidebar or inspector selection changes
- Menu or keyboard command actions
- Menu bar extra actions
- Background load/sync/import events
- Error and recovery paths
2. Add the smallest useful instrumentation.
- Create one `Logger` per feature area or type.
- Log action boundaries and key state transitions.
- Prefer one high-signal line per user action over noisy value dumps.
3. Build and run the app.
- Use `macos-build-run-debug` for the build/run loop.
- If `script/build_and_run.sh` exists, prefer `./script/build_and_run.sh --telemetry` for live telemetry checks or `./script/build_and_run.sh --logs` for broader process logs.
- Exercise the UI or command path that should emit telemetry.
4. Read runtime logs and verify the event fired.
- Use Console.app with a process/subsystem filter when that is the fastest manual check.
- Use `log stream --style compact --predicate 'process == "AppName"'` for live terminal verification.
- Prefer tighter predicates when you know the subsystem/category:
`log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'`
5. Tighten or remove instrumentation.
- If the event fires, keep only the logs that remain useful for future debugging.
- If it does not fire, move the log closer to the suspected control path and rerun.
## Verification Checklist
- The app builds after telemetry changes.
- The relevant action emits exactly one clear log line or a small bounded sequence.
- The log can be filtered by process, subsystem, or category.
- No sensitive payloads are written to unified logs.
- Noisy temporary debug logs are removed or demoted before finishing.
## Guardrails
- Do not use `print` as the primary app telemetry mechanism for macOS app code.
- Do not leave a dense trail of permanent debug logs around every state mutation.
- Do not claim an event is wired correctly until you have a concrete verification path through Console, `log stream`, or captured process output.
- If the debugging task is mostly about crash/backtrace analysis rather than action telemetry, switch to `macos-build-run-debug`.
Wersje
W bazie nie ma innych skilli o nazwie macos-telemetry.
Migawka bazy z 13.11.2026 · wersja paczki 864d58949adb (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100local-telemetry-c457cd7c
Dodaje i sprawdza lekką telemetrię aplikacji macOS: zdarzenia Logger dla okien, pasków bocznych, menu i akcji. - 90apple-runtime-telemetry-workflow
Dodaje i weryfikuje logowanie z poszanowaniem prywatności oraz signposty w aplikacjach macOS i iOS: kategorie Logger, diagnozowanie sporadycznych błędów i pomiary z OSSignposter. - 100axiom-macos
Pomaga tworzyć aplikacje macOS, w tym wzorce SwiftUI dla Maca, okna, menu, sandboxing i wdrożenia. - 100axiom-macos
Pomaga budować aplikacje macOS: okna, menu, piaskownicę, dystrybucję, mostkowanie z AppKit i dotyk. - 100telemetry-essentials
Pomaga dodać logowanie, metryki i instrumentację w Elixirze: metadane Loggera, handlery :telemetry, Telemetry.Metrics i OpenTelemetry. - 95macos-native
Wspiera tworzenie natywnych aplikacji na Maca z użyciem AppKit, Catalyst i API specyficznych dla macOS, w tym aplikacji paska menu i rozszerzeń systemowych.