Agf Deploying Uat

Runbook per avviare uno stack Docker Compose UAT locale isolato e testarlo rapidamente prima del passaggio di consegne

Richiede configurazione ★ 8.0/10

Cosa fa

Un runbook passo-passo per il ruolo di deploy-engineer di AppGenesisForge che distribuisce codice unito a main su uno stack Docker Compose UAT locale fisicamente isolato (nome progetto indipendente più offset porta +900), esegue la migrazione Alembic in-container e testa rapidamente con output curl/psql reali prima di passare al qa-engineer. Si attiva dopo la revisione del codice più il superamento dell'audit SIT e l'unione a main, quando un product-lead conferma "deploy UAT" o esegue /agf-deploy-uat. Esclude gli upload di mini-programmi e i test di accettazione E2E/UAT, che appartengono ad altri ruoli.

Rapporto di test

Recuperato il SKILL.md e controllati i suoi tre file referenziati tramite GitHub raw: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); greppato deployment.md e confermato che le sezioni citate "UAT 环境部署" §6 e "P0/P1 强制门" più l'offset letterale +900 (6332/8900/8980) esistono realmente e corrispondono alla skill. Il frontmatter viene analizzato con name+description; il corpo contiene solo comandi standard docker compose / curl / psql senza curl|sh, base64, esfiltrazione di segreti o testo di iniezione; i percorsi usano ${APP_NAME}/localhost/relative, nessun percorso macchina hardcoded. Impossibile eseguire la fase di output: il deployment richiede un demone Docker attivo, lo stack compose del progetto e un file di segreti .env.uat che non posso eseguire — produrre un report di deployment ripeterebbe solo il template della skill, quindi outputMeasured=false e verdict=setup.

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

Installazione

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.

Comandi e prompt di esempio

/agf-deploying-uatRunbook per avviare uno stack Docker Compose UAT locale isolato e testarlo rapidamente prima del passaggio di consegne

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

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

Rapporto completo →