Agf Deploying Uat

Runbook pour démarrer une stack UAT locale isolée et la tester sommairement avant le transfert

par pcliangx · pcliangx/AppGenesisForge

Fonctionne avec configuration ★ 8.0/10

Agf Deploying Uat — Runbook pour démarrer une stack UAT locale isolée et la tester sommairement avant le transfert

Ce que fait

Un runbook étape par étape pour le rôle d'ingénieur de déploiement AppGenesisForge qui déploie le code fusionné vers main sur une stack Docker Compose UAT locale physiquement isolée (nom de projet indépendant plus décalage de port +900), exécute la migration Alembic dans le conteneur, et effectue des tests sommaires avec une sortie curl/psql réelle avant de transférer au qa-engineer. Se déclenche après la revue de code plus le passage de l'audit SIT et la fusion vers main, lorsqu'un chef de produit confirme "deploy UAT" ou exécute /agf-deploy-uat. Exclut les téléchargements de mini-programmes et les tests d'acceptation E2E/UAT, qui appartiennent à d'autres rôles.

Rapport de test

Récupéré le SKILL.md et vérifié ses trois fichiers référencés via GitHub brut : .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200) ; greppé deployment.md et confirmé que les sections citées "UAT 环境部署" §6 et "P0/P1 强制门" plus le décalage littéral +900 (6332/8900/8980) existent réellement et correspondent à la compétence. Le frontmatter est parsé avec name+description ; le corps ne contient que des commandes docker compose / curl / psql standard sans curl|sh, base64, exfiltration de secrets ou texte d'injection ; les chemins utilisent ${APP_NAME}/localhost/relative, pas de chemins machine codés en dur. N'a pas pu exécuter la phase de sortie : le déploiement nécessite un démon Docker actif, la stack compose du projet et un fichier de secrets .env.uat que je ne peux pas exécuter — produire un rapport de déploiement ne ferait que répéter le propre modèle de la compétence, donc outputMeasured=false et verdict=setup.

Testé le: 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.

Commandes et exemples de prompts

  • /agf-deploying-uatRunbook pour démarrer une stack UAT locale isolée et la tester sommairement avant le transfert

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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