Anúncio de Lançamento

Escreva o anúncio apropriado para o canal de um lançamento sem causar alvoroço. Superfícies diferentes precisam de formatos diferentes: uma entrada de changelog não é um post de blog, que não é um card social. O critério é: um leitor da superfície escolhida pode decidir em menos de 30 segundos se este lançamento o afeta e, em caso afirmativo, o que fazer.

Quando usar

• Uma versão, recurso ou correção está sendo enviada e precisa de um texto para pelo menos uma superfície.
• Um recurso anteriormente privado está se tornando GA (Geralmente Disponível).
• Uma mudança que quebra a compatibilidade precisa ser comunicada antes que os usuários a encontrem.

Quando não usar

• Uma mudança apenas interna sem impacto no usuário. Atualize a documentação interna; não anuncie.
• O lançamento está incompleto (ainda em desenvolvimento ativo). Espere até que seja enviado, mesmo que o marketing queira o post.

Saída de Casos do Paperclip

Quando esta habilidade é executada dentro do Paperclip e experimental.enableCases está habilitada, gere casos de conteúdo de lançamento duráveis antes de entregar a cópia. Os casos preservam a saída inspecionável; o problema coordena o trabalho.

Use skills/paperclip/references/cases.md para o contrato da API. Inclua X-Paperclip-Run-Id nas escritas quando PAPERCLIP_RUN_ID estiver definido. Se a API retornar 403 Cases are disabled, relate essa limitação e continue com o artefato de cópia solicitado.

Atualize o caso de lançamento pai primeiro quando ele ainda não existir:

{
  "caseType": "release",
  "key": "paperclip-release:vYYYY.MDD.P",
  "title": "Paperclip vYYYY.MDD.P release",
  "status": "in_progress",
  "fields": {
    "schema_version": 1,
    "version": "vYYYY.MDD.P",
    "release_date": "YYYY-MM-DD",
    "release_patch": 0,
    "stable": true,
    "channels": ["blog_post", "tweet_storm"],
    "artifacts": {
      "changelog_path": "releases/vYYYY.MDD.P.md",
      "publish_url": null
    }
  }
}

Para um blog de desenvolvimento, atualize um caso filho com parentCaseId definido para o caso de lançamento:

{
  "caseType": "blog_post",
  "key": "paperclip-release:vYYYY.MDD.P:blog-post",
  "title": "Paperclip vYYYY.MDD.P launch post",
  "status": "in_review",
  "parentCaseId": "<release-case-id>",
  "fields": {
    "schema_version": 1,
    "version": "vYYYY.MDD.P",
    "slug": "paperclip-vYYYY-MDD-P",
    "word_count_target": 650,
    "target_audience": ["operators", "developers"],
    "requires_screenshot": false,
    "links": {
      "release_notes": "releases/vYYYY.MDD.P.md",
      "publish_url": null
    },
    "sections": ["hook", "whats_new", "upgrade", "whats_next"]
  }
}

Para saída social, atualize um caso filho irmão:

{
  "caseType": "tweet_storm",
  "key": "paperclip-release:vYYYY.MDD.P:tweet-storm",
  "title": "Paperclip vYYYY.MDD.P tweet storm",
  "status": "in_review",
  "parentCaseId": "<release-case-id>",
  "fields": {
    "schema_version": 1,
    "version": "vYYYY.MDD.P",
    "post_count": 1,
    "channel": "x",
    "target_audience": ["operators", "contributors"],
    "links": {
      "release_notes": "releases/vYYYY.MDD.P.md",
      "publish_url": null
    },
    "review": {
      "needs_human_copy_paste": true,
      "approved_by": null
    }
  }
}

Escreva a cópia produzida em PUT /api/cases/:caseId/documents/body com format: "markdown" e um changeSummary. Busque a revisão mais recente do documento e passe baseRevisionId ao atualizar um corpo de documento existente.

Determine o público e o canal primeiro

Escolha o público para este texto. Um lançamento geralmente precisa de vários textos; não os misture.

Estrutura universal

Independentemente do canal, comece com:

1. O que mudou. Uma frase no vocabulário do usuário.
2. Quem afeta. Qual função de usuário / caso de uso.
3. O que fazer. Migrar agora / optar por participar / nenhuma ação necessária.

Todo o resto é profundidade que suporta esses três.

Modelos de canal

Entrada de changelog (conciso)

## v1.42.0 — 2026-05-26

### Adicionado
- <recurso> — <benefício de uma linha para o usuário>. ([#1234](link))

### Alterado
- <mudança> — <impacto de uma linha>. ([#1235](link))

### Corrigido
- <bug> — <sintoma visível para o usuário de uma linha>. ([#1236](link))


…