Operações do Calendário Editorial
Visão Geral
Mantenha um backlog editorial durável e selecione o próximo trabalho com base em evidências, e não na intuição. Esta skill equilibra clusters de tópicos e formatos de postagem configurados, reserva slots de publicação e reconcilia o estado local com o CMS real antes de alterar a fila.
Ela coordena blog-topic-research e seo-blog-writer; não substitui suas funções de pesquisa, redação, revisão ou publicação.
Pré-requisitos
- Um
config.jsonaprovado definindotarget_platform, autor, cadência UTC, metas de cluster, metas de formato e mapeamentos de tags do CMS - Um
backlog.jsongravável com IDs estáveis, títulos, clusters, formatos, URLs de evidência, prioridades, status e timestamps agendados - Acesso de listagem do CMS somente leitura para
sync; acesso de gravação aprovado separadamente apenas quando o usuário solicitar agendamento ou publicação blog-topic-researchpara reabastecimento do backlog eseo-blog-writerpara produção de rascunhos- Pesos de metas de tópico e formato que totalizam aproximadamente
1.0cada
Disciplina de Ferramentas
Use Read para inspecionar a configuração e o estado do backlog. Use WebSearch e WebFetch apenas para confirmar evidências públicas ou ler o inventário autorizado do CMS. Use Write ou Edit para atualizações de estado revisadas e sem segredos; nunca escreva credenciais, tokens de acesso brutos ou conteúdo sensível não publicado em recibos.
Instruções
- Parseie a ação solicitada:
status,next,add,mark-doneousync. Rejeite ações desconhecidas e flags de agendamento mutuamente incompatíveis. - Leia e valide
config.jsonebacklog.json. Confirme IDs únicos, status válidos, timestamps UTC parseáveis, prioridades não negativas e pesos de destino próximos de1.0. - Execute uma reconciliação somente leitura antes da seleção. Corresponda registros do CMS pelo ID CMS estável primeiro, URL canônica em segundo, e slug normalizado apenas como último recurso. Relate correspondências ambíguas em vez de adivinhar.
- Para
next, pontue apenas itensreadyelegíveis. Classifique primeiro o déficit do cluster, depois o déficit do formato, força da evidência, prioridade explícita e a data de criação mais antiga. Registre os fatores de pontuação para que a escolha seja reproduzível. - Reserve o item selecionado com um ID de execução estável. Para
--draft, invoque o escritor sem um horário de publicação. Caso contrário, escolha o próximo slot UTC configurado livre ou valide cada slot explícito. - Exija revisão antes de qualquer publicação ao vivo ou mutação de agendamento. Passe o scaffold do tópico e o destino aprovado para
seo-blog-writer; não copie credenciais do CMS na transferência. - Confirme a transição de estado somente após a operação downstream retornar um ID de rascunho durável, ID do CMS ou falha explícita. Mova
ready -> reserved -> drafted -> scheduled -> published; nunca pule diretamente parapublishedsem evidência do CMS. - Para
add, normalize o título e compare-o com títulos existentes, slugs, URLs canônicas e tokens de erro/versão distintos. Adicione apenas tópicos apoiados por evidências e não duplicados. - Para
mark-done, exija uma URL ao vivo correspondente ou um recibo manual aprovado pelo proprietário. Parasync, preserve notas locais enquanto atualiza apenas campos suportados por evidências do CMS. - Retorne o trabalho escolhido, agenda, mudanças de estado, conflitos e o próximo slot elegível. Deixe itens com falha ou ambíguos recuperáveis.
Contrato de Seleção
Cada registro do backlog deve incluir:
{
"id": "topic-0042",
"title": "How to diagnose webhook signature failures",
"cluster": "integrations",
"format": "how-to-fix",
"status": "ready",
"priority": 2,
"evidence_urls": ["https://example.com/verified-source"],
"scheduled_at": null,
"cms_id": null,
"canonical_url": null
}
A seleção deve ser determinística para a mesma configuração, backlog e snapshot do CMS. Nunca fabrique tráfego, demanda, disponibilidade ou evidência de publicação.
Limites de Aprovação
Peça aprovação do proprietário antes de agendar, publicar, reagendar, excluir, mutar em lote ou sobrescrever o estado do backlog reconciliado. Um status somente leitura ou uma seleção de simulação (dry-run) não requer acesso de gravação ao CMS. Padrão para rascunho quando a intenção de publicação estiver ausente.
Saída
Retorne um recibo operacional compacto contendo:
- ação, ID de execução, timestamp e soma de verificação da configuração
- IDs selecionados e fatores de pontuação
- status antigos e novos
- rascunho, agenda, ID do CMS e URL canônica quando disponíveis
- conflitos, duplicatas ignoradas, deficiências e aprovações necessárias
- próximo slot elegível e acompanhamento recomendado
Tratamento de Erros
| Condição | Resposta |
|---|---|
| Configuração ausente ou inválida | Pare antes da mutação e liste as chaves ou totais inválidos exatos. |
| Inventário do CMS indisponível | Marque a reconciliação como não verificada; permita status local de simulação (dry-run), mas não afirme que um slot está livre ou uma postagem está ao vivo. |
| Dois registros correspondem a uma postagem do CMS | Preserve ambos os registros, relate a colisão e exija uma decisão do proprietário. |
| A criação de rascunho downstream falha | Libere a reserva ou marque-a como blocked com o recibo de falha; não consuma o slot. |
| A fila não tem tópicos elegíveis | Relate a deficiência e invoque blog-topic-research apenas com o cluster e a contagem aprovados. |
| Atualização simultânea altera o backlog | Releia, recalcule e exija confirmação se o item ou slot selecionado mudar. |
Exemplos
Simule as próximas duas seleções sem publicar:
request: next 2 --draft --dry-run
result: topic-0042 (integrations deficit 0.08), topic-0017 (use-cases deficit 0.05)
mutation: none
next_slot_utc: 2026-09-12T06:00:00Z
Reconcile um item já publicado:
request: sync
matched: topic-0042 -> cms_id=post_918 by canonical_url
transition: scheduled -> published
conflicts: 0
Verificação
- Reexecute
statuse confirme que as contagens registradas são iguais aos totais do backlog. - Confirme que nenhum dois registros ativos compartilham um ID do CMS ou URL canônica.
- Confirme que cada timestamp agendado se encaixa em um slot configurado e nenhum slot está duplamente reservado.
- Confirme que cada registro
publishedtem um ID derivado do CMS ou recibo aprovado pelo proprietário. - Confirme que uma segunda simulação (dry-run) contra entradas inalteradas retorna a mesma classificação.
Recursos
- Google Search Central: Creating helpful, reliable, people-first content
- Ghost Admin API overview
- WordPress REST API handbook
- RFC 3339 date and time profile
Próximos Passos
Revise os pesos de destino mensalmente em relação às prioridades reais de negócios e desempenho de pesquisa. Revalide as APIs da plataforma antes de alterar o adaptador de reconciliação.