[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M786D2NGZBCYPQ6DF42T93BM":3,"skill-same:01M786D2NGZBCYPQ6DF42T93BM":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M786D2NGZBCYPQ6DF42T93BM","release-notes",null,"allanpablo\u002Fforja","allanpablo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22358346?v=4","01M786AH79M6N27CC4HZ2AHJTQ","Allan Pablo","01M786AH80CPCTFFMSTRMGEGYF",2,"MIT","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Frelease-notes\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: release-notes\ndescription: Use quando gerar uma release ou escrever um changelog: coleta os commits desde a última tag, decide o incremento de versão semântica a partir do Conventional Commits, escreve as notas de release para os usuários e cria a tag só depois da aprovação.\n---\n\n# Notas de Release\n\nAs notas de release dizem a quem usa o software o que mudou **para essas pessoas**: o que dá para fazer agora, o que foi corrigido e o que elas precisam mudar. Não são um log de commits.\n\nA saída padrão é uma **versão e uma seção de changelog propostas**. Edite o changelog, crie a tag ou publique uma release só depois que o usuário aprovar.\n\n## Convenções\n\n- Entradas: commits escritos com `commit-message` (Conventional Commits), PRs mesclados de `pull-request`.\n- Versionamento: [Semantic Versioning](https:\u002F\u002Fsemver.org\u002F). Changelog: [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002F).\n- Idioma: o usado no `CHANGELOG.md` existente. Inglês quando não houver um.\n- As regras do repositório prevalecem: uma ferramenta de release existente (`release-please`, `semantic-release`, `changesets`) é dona do processo. Nesse caso, só redija o texto ou ajude a configurar a ferramenta.\n\n## Reúna o contexto\n\n1. `git describe --tags --abbrev=0`: a última tag de release. Nenhuma significa a primeira release.\n2. `git log \u003Cultima-tag>..HEAD --format='%h %s%n%b'`: assuntos **e** corpos, para pegar os rodapés `BREAKING CHANGE:`.\n3. O `CHANGELOG.md`, se existir, para o formato e o tom.\n4. PRs mesclados desde a tag (`gh pr list --state merged --search \"merged:>=\u003Cdata da tag>\"`), para o contexto voltado ao usuário que os commits não têm.\n\n## Incremento de versão\n\n| Os commits desde a última tag contêm | Incremento |\n|---|---|\n| `!` ou um rodapé `BREAKING CHANGE:` | major |\n| `feat` | minor |\n| só `fix`, `perf` | patch |\n| só `docs`, `test`, `ci`, `chore`, `build`, `style`, `refactor` | nenhuma release necessária; diga isso |\n\n- Antes da `1.0.0`, uma mudança incompatível incrementa a versão minor e uma funcionalidade incrementa a patch. Pergunte se o projeto está pronto para a `1.0.0` em vez de decidir sozinho.\n- Commits que não seguem Conventional Commits: leia o diff, classifique-os e liste-os como incertos.\n- Pré-releases (`-rc.1`, `-beta.1`) só a pedido.\n\n## Escrevendo as notas\n\n- **Mudanças incompatíveis primeiro**, cada uma com o passo de migração.\n- Agrupe o resto nas seções do Keep a Changelog: Added (`feat`), Fixed (`fix`), Changed (`perf`, mudanças de comportamento), Deprecated, Removed, Security. Use os nomes de seção em português quando o changelog do projeto já os usa (Adicionado, Corrigido, Alterado…).\n- Reescreva cada entrada para os usuários: o efeito, não a implementação. `feat(reports): add CSV export` → \"Os relatórios podem ser exportados em CSV.\"\n- Junte vários commits numa entrada quando eles entregam uma mudança só.\n- Descarte `ci`, `test`, `chore`, `build`, `style` e `refactor` puro, a menos que os usuários os percebam (por exemplo, uma versão mínima de runtime mais alta).\n- Ligue o PR ou o ticket de cada entrada quando houver.\n- Correções de segurança: declare o impacto e as versões afetadas. Não inclua detalhes de exploração antes de os usuários poderem atualizar.\n\n## Formato\n\n```markdown\n## [\u003Cversão>] - \u003CAAAA-MM-DD>\n\n### ⚠ Mudanças incompatíveis\n- \u003Co que mudou>. Migração: \u003Co que fazer>.\n\n### Added\n- \u003Cefeito visível ao usuário> (#\u003CPR>)\n\n### Fixed\n- \u003Co que estava quebrado e agora funciona> (#\u003CPR>)\n\n### Changed\n- \u003Cmudança de comportamento ou de desempenho>\n```\n\nA seção nova vai no topo do `CHANGELOG.md`, abaixo de `## [Unreleased]` se esse título existir.\n\n## Fluxo\n\n1. Reúna o contexto.\n2. Proponha a versão com os commits que a justificam, mais as notas.\n3. Com a aprovação: atualize o `CHANGELOG.md` e os arquivos de versão que o projeto usa (`package.json`, `pyproject.toml` etc.), e faça o commit com `commit-message` (`chore(release): \u003Cversão>`).\n4. Só se pedirem: `git tag -a v\u003Cversão> -m \"\u003Cversão>\"`, envie a tag, `gh release create v\u003Cversão> --notes-file -`.\n\n## No Forja\n\nNo Forja, a entrada de cada versão no `CHANGELOG.md` abre com a subseção `### O que melhorou` (o diff de produto em relação à versão anterior, em linguagem de usuário) e só depois as seções técnicas. Esse bloco é reaproveitado como nota da release no GitHub, e o README é reconciliado na mesma entrega.\n\n## Evite\n\n- Colar o log de commits cru como notas de release.\n- Detalhes de implementação com os quais os usuários não podem fazer nada.\n- Esconder uma mudança incompatível dentro de \"Changed\".\n- Incrementar a major numa mudança compatível, ou a patch numa funcionalidade nova.\n- Criar tag, enviar ou publicar sem aprovação.\n- Brigar com uma ferramenta de release existente usando passos manuais.\n","# Notas de Release\n\nAs notas de release dizem a quem usa o software o que mudou **para essas pessoas**: o que dá para fazer agora, o que foi corrigido e o que elas precisam mudar. Não são um log de commits.\n\nA saída padrão é uma **versão e uma seção de changelog propostas**. Edite o changelog, crie a tag ou publique uma release só depois que o usuário aprovar.\n\n## Convenções\n\n- Entradas: commits escritos com `commit-message` (Conventional Commits), PRs mesclados de `pull-request`.\n- Versionamento: [Semantic Versioning](https:\u002F\u002Fsemver.org\u002F). Changelog: [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002F).\n- Idioma: o usado no `CHANGELOG.md` existente. Inglês quando não houver um.\n- As regras do repositório prevalecem: uma ferramenta de release existente (`release-please`, `semantic-release`, `changesets`) é dona do processo. Nesse caso, só redija o texto ou ajude a configurar a ferramenta.\n\n## Reúna o contexto\n\n1. `git describe --tags --abbrev=0`: a última tag de release. Nenhuma significa a primeira release.\n2. `git log \u003Cultima-tag>..HEAD --format='%h %s%n%b'`: assuntos **e** corpos, para pegar os rodapés `BREAKING CHANGE:`.\n3. O `CHANGELOG.md`, se existir, para o formato e o tom.\n4. PRs mesclados desde a tag (`gh pr list --state merged --search \"merged:>=\u003Cdata da tag>\"`), para o contexto voltado ao usuário que os commits não têm.\n\n## Incremento de versão\n\n| Os commits desde a última tag contêm | Incremento |\n|---|---|\n| `!` ou um rodapé `BREAKING CHANGE:` | major |\n| `feat` | minor |\n| só `fix`, `perf` | patch |\n| só `docs`, `test`, `ci`, `chore`, `build`, `style`, `refactor` | nenhuma release necessária; diga isso |\n\n- Antes da `1.0.0`, uma mudança incompatível incrementa a versão minor e uma funcionalidade incrementa a patch. Pergunte se o projeto está pronto para a `1.0.0` em vez de decidir sozinho.\n- Commits que não seguem Conventional Commits: leia o diff, classifique-os e liste-os como incertos.\n- Pré-releases (`-rc.1`, `-beta.1`) só a pedido.\n\n## Escrevendo as notas\n\n- **Mudanças incompatíveis primeiro**, cada uma com o passo de migração.\n- Agrupe o resto nas seções do Keep a Changelog: Added (`feat`), Fixed (`fix`), Changed (`perf`, mudanças de comportamento), Deprecated, Removed, Security. Use os nomes de seção em português quando o changelog do projeto já os usa (Adicionado, Corrigido, Alterado…).\n- Reescreva cada entrada para os usuários: o efeito, não a implementação. `feat(reports): add CSV export` → \"Os relatórios podem ser exportados em CSV.\"\n- Junte vários commits numa entrada quando eles entregam uma mudança só.\n- Descarte `ci`, `test`, `chore`, `build`, `style` e `refactor` puro, a menos que os usuários os percebam (por exemplo, uma versão mínima de runtime mais alta).\n- Ligue o PR ou o ticket de cada entrada quando houver.\n- Correções de segurança: declare o impacto e as versões afetadas. Não inclua detalhes de exploração antes de os usuários poderem atualizar.\n\n## Formato\n\n```markdown\n## [\u003Cversão>] - \u003CAAAA-MM-DD>\n\n### ⚠ Mudanças incompatíveis\n- \u003Co que mudou>. Migração: \u003Co que fazer>.\n\n### Added\n- \u003Cefeito visível ao usuário> (#\u003CPR>)\n\n### Fixed\n- \u003Co que estava quebrado e agora funciona> (#\u003CPR>)\n\n### Changed\n- \u003Cmudança de comportamento ou de desempenho>\n```\n\nA seção nova vai no topo do `CHANGELOG.md`, abaixo de `## [Unreleased]` se esse título existir.\n\n## Fluxo\n\n1. Reúna o contexto.\n2. Proponha a versão com os commits que a justificam, mais as notas.\n3. Com a aprovação: atualize o `CHANGELOG.md` e os arquivos de versão que o projeto usa (`package.json`, `pyproject.toml` etc.), e faça o commit com `commit-message` (`chore(release): \u003Cversão>`).\n4. Só se pedirem: `git tag -a v\u003Cversão> -m \"\u003Cversão>\"`, envie a tag, `gh release create v\u003Cversão> --notes-file -`.\n\n## No Forja\n\nNo Forja, a entrada de cada versão no `CHANGELOG.md` abre com a subseção `### O que melhorou` (o diff de produto em relação à versão anterior, em linguagem de usuário) e só depois as seções técnicas. Esse bloco é reaproveitado como nota da release no GitHub, e o README é reconciliado na mesma entrega.\n\n## Evite\n\n- Colar o log de commits cru como notas de release.\n- Detalhes de implementação com os quais os usuários não podem fazer nada.\n- Esconder uma mudança incompatível dentro de \"Changed\".\n- Incrementar a major numa mudança compatível, ou a patch numa funcionalidade nova.\n- Criar tag, enviar ou publicar sem aprovação.\n- Brigar com uma ferramenta de release existente usando passos manuais.\n",{},"main","cfe29d604e93a4c19fd25db4289328f6ec17bb41","templates\u002Fproject\u002Fskills\u002Frelease-notes",0,"https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja","npmjs.com\u002Fforjajs","https:\u002F\u002Fgithub.com\u002Fallanpablo","www.allanpablo.com.br","Gestor de TI","2026-11-15 05:12:58",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add allanpablo\u002Fforja --skill release-notes",{"tool":39,"command":40},"bunx","bunx skills add allanpablo\u002Fforja --skill release-notes",{"tool":42,"command":43},"pnpm","pnpm dlx skills add allanpablo\u002Fforja --skill release-notes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Frelease-notes\u002FSKILL.md",true,[],[48,54,60,66,72,78],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M786DTCHHV8K0MZMQQA2N81Q","web-performance","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fweb-performance\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M786DQ9FDGFMJTF6WANNJ7QG","ts-testing","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-testing\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M786DMASM9PXP0NSEZYTHA7Q","ts-module-layout","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-module-layout\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M786DH4Y3AD551JN35D2R3HY","ts-code-review","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-code-review\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M786DF1R7PCK6KB44B34110S","ts-async-patterns","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-async-patterns\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M786DDCF8GHQ8KY2X4DGY3XN","threat-modeling","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fthreat-modeling\u002FSKILL.md",[],[]]