aiox-publish
Executa a publicação segura de alterações: gates pré-push, verificação de story fechada, QA aprovado e push via @devops. Usar quando o usuário solicitar publicação, push, deploy ou release.
SKILL.md.claude/skills/aiox-publish/SKILL.md
GitHubAIOX Publish — Publicação Segura
Quando esta skill é acionada
- "publique as alterações"
- "faça o push"
- "deploy"
- "release"
- "mande para produção"
- Qualquer solicitação de publicação ou operação remota
Pré-condições (todas verificadas antes do push)
- Story fechada pelo @po (status Done)
- QA veredito aceitável (PASS, CONCERNS ou WAIVED)
- Lint passa (
ruff check scripts/) - Typecheck passa (
mypy scripts/) - Testes passam (
pytest) - Build passa (se aplicável)
- Nenhum débito HIGH introduzido sem registro
- ChangeLog e File List atualizados
Sequência
@qa (gate final) → @devops (push/PR/release)
Fase 1: Gate final (@qa)
Agente: aiox-qa
- Verificar todas as pré-condições
- Executar
/quality-gate+/code-review - Emitir veredito final de publicação
Fase 2: Push (@devops)
Agente: aiox-devops
- Único autorizado a executar
git push - Criar PR se aplicável
- Criar release/tag se aplicável
- Atualizar
touch .claude/.pre-push-passed
Bloqueios (hooks)
| Hook | O que bloqueia |
|---|---|
enforce-git-push-authority.cjs |
Push por agente que não é @devops |
pre-push-gate.cjs |
Push/commit sem validação recente |
no-story-no-edit.cjs |
Edição de código sem story ativa |
db-destructive-guard.cjs |
Operação DB destrutiva sem HIGH-RISK |
Condições de interrupção
- Qualquer pré-condição falha → bloqueia push, informa gate faltante
- Push para branch protegida → requer autorização explícita
--forceou--force-with-lease→ bloqueado salvo procedimento autorizado- Story não fechada → "Story deve ser fechada pelo @po antes do push"
Operações permitidas apenas ao @devops
git pushgit push --force(com autorização explícita)gh pr creategh pr mergegit taggh release create- MCP add/remove/configure
- CI/CD pipeline management
Referências
- Hooks:
.claude/settings.local.json,.claude/hooks/ - Agent authority:
.claude/rules/agent-authority.md - Protocolo:
.claude/rules/aiox-project-operating-protocol.md