Agf Releasing Apple

Runbook per firma, notarizzazione, packaging e smoke-testing di build di rilascio Apple

di pcliangx · pcliangx/AppGenesisForge

Richiede configurazione ★ 7.6/10

Agf Releasing Apple — Runbook per firma, notarizzazione, packaging e smoke-testing di build di rilascio Apple

Cosa fa

Un runbook passo-passo per il ruolo di apple-release-engineer: costruisce una build distribuibile firmata (build TestFlight, DMG notariata, o pacchetto interno) da codice unito a main, quindi esegue uno smoke test con output reale e passa il controllo al QA. Si attiva quando qualcuno chiede di costruire, notariizzare o pacchettizzare una build di rilascio Apple dopo la revisione del codice e il merge; esclude esplicitamente web docker UAT e test di accettazione E2E/UAT.

Rapporto di test

Individuato SKILL.md tramite l'API tree di GitHub in .claude/skills/agf-releasing-apple/SKILL.md e recuperato raw. Il frontmatter viene analizzato con nome+descrizione; controllati tutti e quattro i riferimenti nel corpo (deployment.md, versioning.md, ADR-009, il comando /agf-apple-release) tramite fetch raw — tutti HTTP 200. Nessun odore di sicurezza; la skill proibisce attivamente il commit di .p8/.p12/mobileprovision e impone segreti env-var/Keychain. Non è stato possibile eseguire OUTPUT vs baseline: il lavoro reale della skill (xcodebuild, `bundle exec fastlane beta/release_dmg`, Apple notarytool, upload TestFlight, smoke test `spctl -a -vv`) richiede materiale di firma macOS e credenziali sviluppatore Apple non disponibili nella mia sandbox, quindi non esiste alcun artefatto di build da confrontare.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/pcliangx/AppGenesisForge.git /tmp/agf-releasing-apple-src
mkdir -p ~/.claude/skills
cp -R /tmp/agf-releasing-apple-src/.claude/skills/agf-releasing-apple ~/.claude/skills/agf-releasing-apple
# Runbook only — the actual build requires macOS + Xcode (`xcodebuild`), Ruby/Bundler + fastlane
#   (`bundle exec fastlane <lane>`), an App Store Connect API key (.p8), and a `match` cert repo.
# It is tightly coupled to the AppGenesisForge repo: SKILL.md cross-references
#   .claude/standards/deployment.md §7, .claude/standards/versioning.md, docs/adr/009-apple-release-pipeline.md,
#   and slash command .claude/commands/agf-apple-release.md — outside that repo those links dangle.

Comandi e prompt di esempio

  • /agf-releasing-appleRunbook per firma, notarizzazione, packaging e smoke-testing di build di rilascio Apple

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Build and notarize a TestFlight release from main
  • Run pre-flight checks before releasing to Apple
  • Package a notarized DMG for this release channel