Agf Deploying Uat

Runbook pro spuštění izolovaného lokálního UAT compose stacku a jeho smoke-testování před předáním

od pcliangx · pcliangx/AppGenesisForge

Funguje s nastavením ★ 8.0/10

Agf Deploying Uat — Runbook pro spuštění izolovaného lokálního UAT compose stacku a jeho smoke-testování před předáním

Co umí

Krok za krokem runbook pro roli AppGenesisForge deploy-engineer, který nasazuje kód sloučený do main na fyzicky izolovaný lokální UAT Docker Compose stack (nezávislý název projektu plus offset portu +900), spouští in-container Alembic migraci a provádí smoke-testy s reálným výstupem curl/psql před předáním qa-engineerovi. Spouští se po code review plus SIT auditu a sloučení do main, když product-lead potvrdí "deploy UAT" nebo spustí /agf-deploy-uat. Vylučuje nahrávání mini-programů a E2E/UAT akceptační testování, které patří k jiným rolím.

Testovací report

Načten SKILL.md a bodově zkontrolovány jeho tři odkazované soubory přes raw GitHub: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); prohledán deployment.md a potvrzeno, že citované sekce "UAT 环境部署" §6 a "P0/P1 强制门" plus doslovný offset +900 (6332/8900/8980) skutečně existují a odpovídají skillu. Frontmatter se parsuje s name+description; tělo obsahuje pouze standardní docker compose / curl / psql příkazy bez curl|sh, base64, exfiltrace tajemství nebo injection textu; cesty používají ${APP_NAME}/localhost/relative, žádné pevně zakódované cesty k počítači. Nemohl jsem spustit výstupní fázi: nasazení vyžaduje živý Docker daemon, compose stack projektu a soubor .env.uat s tajemstvími, který nemohu spustit — vytvoření zprávy o nasazení by pouze zopakovalo vlastní šablonu skillu, takže outputMeasured=false a verdict=setup.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

git clone --depth 1 https://github.com/pcliangx/AppGenesisForge.git /tmp/agf-deploying-uat-src
mkdir -p ~/.claude/skills
cp -R /tmp/agf-deploying-uat-src/.claude/skills/agf-deploying-uat ~/.claude/skills/agf-deploying-uat
# Runbook is project-specific to AppGenesisForge. To actually execute a deploy you need:
#   - Docker daemon running (docker compose version)
#   - The AppGenesisForge repo with its docker-compose files (frontend + backend + postgres)
#   - A .env.uat file (gitignored, holds DB/LLM secrets + port-offset vars) you provide
#   - Free +900 ports: 6332 (postgres) / 8900 (backend) / 8980 (frontend/caddy)
# The skill also references ../../standards/deployment.md (single source for the isolation
# contract); that file lives in the same repo under .claude/standards/deployment.md.

Příkazy a ukázkové prompty

  • /agf-deploying-uatRunbook pro spuštění izolovaného lokálního UAT compose stacku a jeho smoke-testování před předáním

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • Deploy the merged main branch to the UAT stack
  • Run pre-flight checks before the UAT deployment
  • Bring up the isolated UAT compose environment