Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

macos-distribution-workflow

/macos-distribution-workflow

Sprawdza, przygotowuje, waliduje i diagnozuje wyeksportowane artefakty dystrybucji macOS: tożsamości podpisu, entitlements, hardened runtime, Gatekeeper, notaryzację i stapling.

Repozytorium
socket ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
26.08.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Sprawdza, przygotowuje, waliduje i diagnozuje wyeksportowane artefakty dystrybucji macOS: tożsamości podpisu, entitlements, hardened runtime, Gatekeeper, notaryzację i stapling.

Oryginalny opis (EN)

Inspect, prepare, validate, and troubleshoot exported macOS distribution artifacts. Use when checking signing identities, entitlements, hardened runtime, nested code, Gatekeeper, notarization readiness/results, stapling, or distribution-only launch failures.

Jak działa

  1. Purpose
  2. When To Use
  3. Single-Path Workflow
  4. Inputs
  5. Outputs
  6. Guards and Stop Conditions
  7. Fallbacks and Handoffs
  8. References
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 462 słów
Podgląd SKILL.md
---
name: macos-distribution-workflow
description: Inspect, prepare, validate, and troubleshoot exported macOS distribution artifacts. Use when checking signing identities, entitlements, hardened runtime, nested code, Gatekeeper, notarization readiness/results, stapling, or distribution-only launch failures.
---

# macOS Distribution Workflow

## Purpose

Treat a signed exported artifact as the source of truth for macOS distribution diagnosis. This workflow distinguishes project/account provisioning from artifact trust: inspect the bundle, classify the failure, and use the minimum verifiable repair or release-validation path.

## When To Use

- Use for `.app`, `.pkg`, or disk-image distribution artifacts; signing state; entitlements; hardened runtime; nested signatures; Gatekeeper; notarization; stapling; and direct-distribution failures.
- Do not use for ordinary Debug builds, account-side certificate/profile creation, or project signing-setting edits without an artifact diagnosis.

## Single-Path Workflow

1. Apply the Apple docs gate through `explore-apple-swift-docs`. Confirm the distribution channel and current signing/notarization requirement before acting.
2. Identify the exact artifact, distribution channel, main executable, nested frameworks/helpers/extensions, signing identity, and observed user-visible failure.
3. Read `references/artifact-inspection-and-classification.md` and inspect bundle structure, signature details, entitlements, nested code, and Gatekeeper assessment before prescribing a fix.
4. Classify the problem: unsigned/ad hoc signing, wrong identity, entitlement mismatch, hardened-runtime issue, nested-code ordering issue, sandbox issue, Gatekeeper assessment, or notarization/stapling readiness.
5. Keep account-side provisioning with `apple-developer-provisioning-workflow`; keep project signing or entitlement edits with `xcode-build-run-workflow`. Do not hand-edit/re-sign a built artifact as a first response to a project configuration problem.
6. For direct distribution, validate the outermost deliverable, notarization result, and stapling state appropriate to the chosen package shape. Keep local-debug validity distinct from distribution readiness.
7. Report the inspected artifact, evidence, failure class, smallest repair path, and the validation that remains after repair.

## Inputs

- exported artifact path and intended distribution channel
- signing identity/entitlement context and nested-code shape
- observed launch, Gatekeeper, notarization, or upload failure
- current Xcode/macOS version and any prior validation output

## Outputs

- artifact inspection result and precise failure classification
- project, account, or artifact owner for the next repair
- minimum validation sequence and distribution-readiness state

## Guards and Stop Conditions

- Do not call notarization necessary for a normal local Debug run.
- Do not invent entitlements, signing identities, or distribution certificates.
- Do not treat a project setting as verified until the exported artifact was inspected.
- Do not re-sign an artifact casually; re-signing can invalidate nested signatures, profiles, or a prior notarization result.
- Stop when the distribution channel, actual artifact, or signing evidence is missing.

## Fallbacks and Handoffs

- Recommend `diagnose-apple-entitlements` when source, profile, main or nested signed entitlements, and runtime authorization need a five-state comparison before choosing a repair owner.
- Recommend `apple-developer-provisioning-workflow` for documented account-side certificates, profiles, and identifier/capability state.
- Recommend `xcode-build-run-workflow` for entitlement/project-signing changes, archive/export, and build validation.
- Recommend `explore-apple-swift-docs` for current signing, notarization, or distribution policy.

## References

- `references/artifact-inspection-and-classification.md`
- Recommend `references/snippets/apple-xcode-project-core.md` when the app needs reusable Xcode-project policy alongside distribution work.
- [Packaging Mac software for distribution](https://developer.apple.com/documentation/xcode/packaging-mac-software-for-distribution) documents distribution packaging and notarization context.
Pliki w paczce (4)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/artifact-inspection-and-classification.md 1 KB
  • references/snippets/apple-xcode-project-core.md 26 KB

Wersje

W bazie nie ma innych skilli o nazwie macos-distribution-workflow.

Migawka bazy z 13.11.2026 · wersja paczki 84fd52b13482 (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

  • 90macos-signing-entitlements
    Sprawdza podpisywanie kodu, uprawnienia i problemy Gatekeepera w aplikacjach macOS, gdy zawodzi sandbox lub zaufanie.
  • 100macos-app-distribution-dmg
    Prowadzi przez dystrybucję aplikacji macOS poza App Store: podpis Developer ID z hardened runtime, notaryzacja notarytool, stapling, budowa obrazu DMG i sprawdzenie uruchomienia na obcym Macu.
  • 90macos-packaging-notarization
    Przygotowuje pakowanie i notaryzację aplikacji macOS: archiwizację, walidację paczki i wyjaśnia błędy dystrybucji.
  • 90analyzing-macos-binaries
    Opisuje ogólne zasady analizy aplikacji na macOS wyłącznie na własnym oprogramowaniu i w ramach przeglądu bezpieczeństwa.
  • 100desktop-release
    Pakuje, podpisuje i notaryzuje aplikację desktopową dla Windows, macOS i Linuksa oraz konfiguruje aktualizacje, z dowodami wydania.
  • 100macos-spm-app-packaging
    Zamienia plik wykonywalny Swift Package Manager w pełnoprawną aplikację .app bez projektu Xcode: buduje bundle i Info.plist, podpisuje, notaryzuje, pakuje do zip lub obrazu dysku i obsługuje kanały Sparkle.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.