Agf Deploying Uat

Runbook til at starte en isoleret lokal UAT compose stack og smoke-teste den før overdragelse

Af pcliangx · pcliangx/AppGenesisForge

Virker med opsætning ★ 8.0/10

Agf Deploying Uat — Runbook til at starte en isoleret lokal UAT compose stack og smoke-teste den før overdragelse

Hvad det gør

En trin-for-trin runbook for AppGenesisForge deploy-engineer-rollen, der udruller merged-to-main kode til en fysisk isoleret lokal UAT Docker Compose stack (uafhængigt projektnavn plus +900 port-offset), kører in-container Alembic-migration og smoke-tester med ægte curl/psql output, før den overdrages til qa-engineer. Udløses efter kodeanmeldelse plus SIT audit pass og merge til main, når en produktleder bekræfter "deploy UAT" eller kører /agf-deploy-uat. Ekskluderer mini-program uploads og E2E/UAT accepttest, som tilhører andre roller.

Testrapport

Hentede SKILL.md og spot-tjekkede dens tre refererede filer via rå GitHub: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); grepped deployment.md og bekræftede, at de citerede "UAT 环境部署" §6 og "P0/P1 强制门" sektioner plus den bogstavelige +900 offset (6332/8900/8980) virkelig eksisterer og matcher skill'en. Frontmatter parses med name+description; body er kun standard docker compose / curl / psql kommandoer uden curl|sh, base64, hemmelig exfiltration eller injection-tekst; stier bruger ${APP_NAME}/localhost/relative, ingen hardkodede maskinstier. Kunne ikke køre output-fasen: udrulning kræver en live Docker-daemon, projektets compose stack og en .env.uat secrets-fil, jeg ikke kan udføre — at producere en udrulningsrapport ville kun gentage skill'ens egen skabelon, so outputMeasured=false og verdict=setup.

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

Installation

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.

Kommandoer og eksempelprompter

  • /agf-deploying-uatRunbook til at starte en isoleret lokal UAT compose stack og smoke-teste den før overdragelse

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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