القائمة
Valida o estado de uma pasta paralela de KB GeneXus antes do push (rotina pré-push de pasta paralela), rodando o orquestrador de gates mecânicos local do repositório ativo; não é a rotina pré-push do repositório de skills (documento 13)
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Generates and clones GeneXus XPZ objects conservatively — validates structure, applies risk rules, serializes envelope
Prepara e valida a estrutura inicial da pasta paralela da KB para carga inicial, sync de XPZ, índice derivado e artefatos de importação
Skill para importação e exportação de XPZ via MSBuild, com execução sem interface gráfica, parâmetros explícitos, rastreabilidade e gates (pontos de liberação ou bloqueio) de segurança
Permite ao agente principal delegar tarefas menores, pedir segunda opinião ou conduzir revisão por pares/peer review de plano/design por painel multi-modelo via opencode, Codex, Claude Code (Opus 4.8), GitHub Copilot CLI ou Gemini CLI; ao receber "revisão por pares", carregar esta skill, perguntar revisores preferidos se não houver preferred-reviewers.json, não presumir assinatura externa e nunca rotular parecer solo como revisão por pares; acionamento sempre humano
Skill para validação de build pós-import via MSBuild, com execução sem interface gráfica, parâmetros explícitos, classificação de resultado e gates de segurança contra reorg não autorizada
Backup auditável para aplicar patch textual Git já aprovado no Codex, em um repositório alvo, quando a rota nativa apply_patch estiver indisponível, falhar antes de escrita local ou for solicitada explicitamente.
| name | xpz-kb-parallel-pre-push |
| description | Valida o estado de uma pasta paralela de KB GeneXus antes do push (rotina pré-push de pasta paralela), rodando o orquestrador de gates mecânicos local do repositório ativo; não é a rotina pré-push do repositório de skills (documento 13) |
Roda a rotina pré-push de uma pasta paralela de KB GeneXus: invoca o orquestrador compartilhado scripts\Invoke-XpzKbParallelPrePushPhase1.ps1 para consolidar gates mecânicos (G0–G5 + K1–K4/K8/K9/K11) sobre o estado dessa pasta antes de um push, e classifica o resultado em pushReadiness (ready/warn/blocked). Reporta ao usuário e não publica nada por conta própria.
Esta skill NÃO é a rotina pré-push do repositório de skills GeneXus-XPZ-Skills — essa é o documento 13-revisao-pre-push.md (e o tier reforçado 14-revisao-pre-push-reforcada.md). Aquela rotina valida o repositório de skills antes de publicar; esta valida o estado de uma pasta paralela de KB (com ObjetosDaKbEmXml/, KbIntelligence/ etc.) antes de o usuário fazer push dessa KB. São coisas diferentes, com autoridade documental diferente.
pushReadiness é a leitura principal. unknown em qualquer gate bloqueia (fail-closed) — nunca tratar unknown como "ok".xpz-kb-parallel-setup antes desta rotina.-AsJson). Se K8/K9 bloquearem por wrapper local ausente, ambíguo ou defasado (sem repasse de -AsJson), a correção é via xpz-kb-parallel-setup (atualizar_bootstrap_local / corrigir_wrapper_local) — não editar o wrapper por conta própria nesta skill.estado_operacional_sugerido) e K9 (status/reason) são contrato compartilhado com xpz-kb-parallel-setup; renomeá-los lá quebra esta rotina (ver fase1-mecanica.md).SKILL.md fica numa subpasta de skill sob a raiz do repositório de skills; os motores compartilhados ficam em ..\scripts\ relativos a esta pasta.../arquivo.md resolve a partir da pasta deste SKILL.md, não do diretório de trabalho corrente.-RepoRoot do orquestrador é a raiz da pasta paralela da KB (alvo da validação), que normalmente não é o repositório de skills onde o motor mora.Use esta skill para:
pushReadiness e os gates de uma rodada já executadaDo NOT use esta skill para:
GeneXus-XPZ-Skills (use o documento 13-revisao-pre-push.md e, opcionalmente, o tier reforçado 14)xpz-kb-parallel-setup)xpz-sync)xpz-builder)xpz-skills-setup)scripts\Invoke-XpzKbParallelPrePushPhase1.ps1 como motor compartilhado e agnóstico de KB; parametrizar caminhos não-padrão pela config local kb-parallel-pre-push.config.json (campos setupAuditWrapper/indexGateWrapper + bloco layerTokens), nunca por edição do motor.pushReadiness como leitura principal; exit 0 ready, 2 warn, 1 blocked; unknown consolida em blocked.config / config apontando arquivo inexistente=block / convention com exatamente 1 candidato=ok / none ou ambiguous=block) e encaminhar correção de wrapper à xpz-kb-parallel-setup.pushReadiness ≠ ready; warn exige decisão consciente do usuário, blocked proíbe push até saneamento.examples/) e parar; correções e push só após autorização explícita.xpz-kb-parallel-setup.git -C <pasta-paralela> fetch origin antes de rodar (ou usar -SkipFetch conscientemente, assumindo a BaseRef local).pwsh -File <repo-skills>\scripts\Invoke-XpzKbParallelPrePushPhase1.ps1 -RepoRoot <pasta-paralela> (JSON de máquina por padrão; -AsText para leitura humana).pushReadiness:
ready (exit 0) → Fase 1 mecânica sem bloqueio; seguir para a triagem 2a/2b.warn (exit 2) → há gate warn (ex.: branch≠main, working tree sujo, whitespace só no acervo ou em XML novo/adicionado da frente); reportar e pedir decisão do usuário. Em G4, warn não autoriza limpeza global: corrigir só linhas novas/editadas; o 9-FD decide trim forte quando houver baseline por GUID único.blocked (exit 1) → há gate block ou unknown; push proibido até saneamento. Diagnosticar cada gate por fase1-mecanica.md.block: se a causa for wrapper local ausente/ambíguo/defasado (resolvedBy = none/ambiguous, ou resolvedBy='config' apontando arquivo inexistente, ou contrato -AsJson não emitido), encaminhar à xpz-kb-parallel-setup (atualizar_bootstrap_local/corrigir_wrapper_local). Não editar o wrapper aqui.Test-XpzKbFrenteHygiene.ps1 (higiene de frente/pacote) — ver fase2a-estrutural.md. A correção dos warn (remover frentes não-conformes / pacotes órfãos) é a forma canônica via Remove-XpzKbFrenteHygieneFindings.ps1 (fail-safe: dry-run por padrão, -Apply sob decisão humana, consome o JSON do motor como fonte de verdade) — NUNCA um passo automático desta rotina nem deleção ad-hoc.Compare-XpzChecksums descarta SAME; roteamento por regime, build como autoridade) — ver fase2b-classificador-de-regime.md. É classificador, não selo determinístico.examples/) e parar. Correções e push só após autorização explícita do usuário.fase1-mecanica.md — contrato dos gates G0–G5 + K1–K4/K8/K9/K11 do orquestrador (severidade consolidada, unknown⇒blocked, exit codes, descoberta de wrapper, parâmetros e tokens de camada).fase2a-estrutural.md — Test-XpzKbFrenteHygiene (diagnóstico) + executor de faxina Remove-XpzKbFrenteHygieneFindings (correção fail-safe, fora da pré-push) + checklist de agente; nuance cabeça-detalhe do F1.fase2b-classificador-de-regime.md — classificador de regime (F1 → roteamento → build como autoridade), catálogo de padrões aceitos por-KB.13.unknown como aprovação; unknown consolida em pushReadiness=blocked (fail-closed).pushReadiness ≠ ready sem decisão explícita do usuário; blocked proíbe push.kb-parallel-pre-push.config.json.xpz-kb-parallel-setup.xpz-kb-parallel-setup); são contrato compartilhado.xpz-kb-parallel-setup antes.