| name | confluence-changelog-publisher |
| description | Publica changelogs e resumos técnicos em páginas do Confluence por meio de Atlassian MCP, com coleta guiada de space, título, localização da página e modo de publicação. Exige aprovação explícita do usuário antes de consultar páginas existentes e antes de criar ou atualizar conteúdo. Use quando precisar publicar changelogs, release notes técnicas, resumos de PR ou relatórios de mudança no Confluence com rastreabilidade e confirmação humana. Não use para publicação automática sem confirmação explícita, para destinos fora do Confluence ou para geração de conteúdo sem um texto-base já preparado. |
Publicador de Changelog no Confluence
Procedimentos
Etapa 1: Validar Entradas de Publicação
- Extraia o conteúdo a ser publicado ou a referência para o texto final já aprovado.
- Extraia ou solicite os campos mínimos de destino:
spacetitle- modo de publicação:
create, update ou decide-after-search
- Extraia, quando disponível, um destes localizadores:
- URL da página existente
- ID da página existente
- título da página-pai
- indicação explícita de publicação na raiz do espaço
- Execute
python3 scripts/validate-confluence-target.py --space "[space]" --title "[title]" --mode "[mode]" [--page-id "..."] [--parent-title "..."] [--root].
- Se a validação falhar, corrija os campos com o usuário antes de continuar.
Etapa 2: Confirmar Antes de Consultar o Confluence
- Resuma a operação pretendida em um bloco curto:
- space
- título da página
- modo de publicação
- localização desejada: página existente, página-pai ou raiz
- Peça aprovação explícita do usuário antes de consultar páginas existentes, pesquisar destinos ou chamar Atlassian MCP.
- Não consulte o Confluence nem chame Atlassian MCP até o usuário confirmar.
Etapa 3: Resolver o Destino da Página
- Se o usuário forneceu URL ou ID da página, trate esse alvo como destino prioritário para
update.
- Se o modo for
decide-after-search, pesquise páginas com o mesmo título no space informado.
- Se houver múltiplas páginas candidatas, mostre opções curtas ao usuário e peça que escolha antes de continuar.
- Se o usuário forneceu página-pai, resolva essa página antes de criar o conteúdo.
- Se o usuário escolheu publicar na raiz do espaço, registre isso explicitamente no plano de publicação.
Etapa 4: Preparar o Conteúdo para Publicação
- Leia
assets/confluence-page-template.md para estruturar o conteúdo quando o texto-base precisar de padronização mínima.
- Preserve o conteúdo aprovado pelo usuário sem reescrever desnecessariamente.
- Garanta que o corpo final contenha, quando aplicável:
- título
- resumo
- changelog ou corpo principal
- breaking changes
- notas de migração ou ação
- metadados de origem
- Leia
references/publishing-rules.md quando precisar decidir entre criar, atualizar ou pedir confirmação adicional.
Etapa 5: Revisar com o Usuário Antes de Escrever
- Mostre um preview curto com:
- título final
- destino resolvido
- modo de publicação
- início do corpo ou resumo do conteúdo
- Peça aprovação explícita do usuário antes de criar ou atualizar a página.
- Não escreva no Confluence até o usuário confirmar.
Etapa 6: Publicar pelo Atlassian MCP
- Se o modo for
create, crie a página no space e no local resolvido.
- Se o modo for
update, atualize somente a página confirmada pelo usuário.
- Se o modo for
decide-after-search, só crie ou atualize depois que o usuário escolher o destino final.
- Preserve o título confirmado e use o corpo final aprovado.
- Após a publicação, informe:
- título publicado
- space
- página criada ou atualizada
- URL ou referência da página, quando disponível
Etapa 7: Encerrar com Rastreabilidade
- Informe se o conteúdo foi criado, atualizado ou mantido como rascunho.
- Registre qualquer limitação observada, como página-pai não encontrada, múltiplos resultados ambíguos ou campos não resolvidos.
- Se a publicação não acontecer, retorne o conteúdo final pronto para uso manual.
Tratamento de Erros
- Se
scripts/validate-confluence-target.py falhar, corrija espaço, título, modo ou localização com o usuário antes de continuar.
- Se o usuário não fornecer conteúdo final, solicite ou reutilize um changelog já aprovado antes de seguir para publicação.
- Se o Confluence retornar múltiplas páginas com títulos semelhantes, não escolha automaticamente; peça confirmação do usuário.
- Se a página-pai não puder ser resolvida, ofereça publicar na raiz do espaço ou pedir outro destino.
- Se a criação ou atualização falhar, informe a falha com objetividade, preserve o corpo final e pare sem repetir tentativas destrutivas.
- Se o usuário aprovar a consulta, mas não aprovar a escrita, encerre com o conteúdo preparado sem publicar.
