apple-app-review

Evite uma rejeição na App Store. Audite um aplicativo iOS com base nas diretrizes que mais causam rejeições, escreva as "Notas para Revisão" do App Store Connect para um aplicativo iOS, responda às 9 perguntas da Apple após uma rejeição da Diretriz 4.3 / 4.2.6 ou monte o pacote da Diretriz 2.1 "histórico limitado de revisão do aplicativo". Use quando alguém estiver prestes a enviar um aplicativo ou atualização, receber uma rejeição da App Store ou perguntar como preencher o campo de notas da Revisão de Aplicativos.

O que é apple-app-review?

Esta skill automatiza a preparação para a revisão de aplicativos iOS na App Store, ajudando desenvolvedores a evitar rejeições comuns. Ela analisa o código do aplicativo e a listagem na loja, verificando os itens que mais causam rejeições com base nas diretrizes oficiais da Apple. A skill extrai informações cruciais do repositório, como fluxos de conta (incluindo exclusão de conta), conteúdo de usuário, compras dentro do aplicativo, SDKs e serviços externos, e mudanças recentes no código. Em seguida, gera automaticamente o texto das "Notas para Revisão" com os detalhes necessários, responde às 9 perguntas da Apple após uma rejeição 4.3/4.2.6, ou monta o pacote de defesa para rejeições 2.1. Suporta os modos 'notes', 'answer-4.3', 'packet-2.1' e 'audit', fornecendo um checklist detalhado para garantir que o aplicativo esteja em conformidade antes do envio.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Git-Agni/apple-app-review-skill/tree/main

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que apple-app-review faz?

Faça o trabalho do revisor antes que ele abra o build. Um revisor tem aproximadamente 13 minutos para um novo aplicativo e 6 para uma atualização (Phillip Shoemaker, que dirigiu a Revisão de Aplicativos de 2009 a 2016). Qualquer coisa que eles não encontrarem ou acessarem nesse tempo se torna uma rejeição.

Regras da própria Apple para este campo (Diretrizes de Revisão da App Store + Ajuda do App Store Connect)

  • As Notas têm até 4000 bytes, em qualquer idioma. Conte bytes, não caracteres, e corte se ultrapassar.
  • 2.3.1(a): "Todos os novos recursos, funcionalidades e mudanças de produto devem ser descritos com especificidade na seção Notas para Revisão... (descrições genéricas serão rejeitadas)."
  • Antes de Enviar: forneça acesso total (conta de demonstração ativa ou modo de demonstração completo), mantenha os serviços de backend ativos durante a revisão, explique recursos não óbvios e compras dentro do aplicativo nas notas.
  • 2.1(a): teste no dispositivo primeiro, inclua informações de conta de demonstração e ative o backend.
  • 2.1(b): toda compra dentro do aplicativo deve estar visível e funcionando; se alguma não puder ser encontrada ou revisada, explique o motivo nas notas.
  • Os campos de Login aceitam uma conta de demonstração que não deve expirar. Contas extras vão nas Notas.
  • Streaming de vídeo por rede celular: forneça uma URL de teste de streaming.

Escolha o modo

  1. notes (padrão): está prestes a enviar um aplicativo ou atualização. Gere o texto das Notas para Revisão.
  2. answer-4.3: recebeu uma rejeição 4.3 / 4.2.6 com as 9 perguntas da Apple. Gere a resposta. Não diga ao usuário para reenviar.
  3. packet-2.1: recebeu "Este aplicativo foi enviado por uma conta de desenvolvedor que tem um histórico limitado de Revisão de Aplicativos." Gere o pacote de 6 itens mais uma lista de gravação.
  4. audit: antes de qualquer envio, percorra o mapa de rejeições em GUIDE.md em relação ao código e à listagem, e imprima aprovado/reprovado com o número da diretriz e a correção para cada um.

Etapa 1: colete fatos (leia o código primeiro, pergunte apenas o que o código não pode dizer)

Do repositório, encontre e liste:

  • O que o aplicativo faz, cada tela principal, cada recurso bloqueado ou com paywall e como acessá-lo.
  • Fluxos de conta: cadastro, login, exclusão de conta (Diretriz 5.1.1(v) exige no aplicativo se houver contas).
  • Conteúdo do usuário: postagem, denúncia e bloqueio (Diretriz 1.2).
  • Compras dentro do aplicativo e assinaturas (IDs de produto, o que cada um desbloqueia).
  • Cada SDK e serviço externo: autenticação, pagamentos, análise, relatórios de falhas, anúncios, provedores de IA (nomeie o fornecedor do modelo), APIs de dados. Verifique Package.swift, Podfile, package.json, build.gradle, Info.plist, chamadas de rede.
  • Qualquer coisa ativada a partir de um servidor, configuração remota ou feature flags. Diga isso claramente; chaves de servidor ocultas são interpretadas como isca e troca (Diretriz 2.5.19).
  • Diferenças regionais, ou confirme que não há.
  • Mudanças neste build (git log desde a última tag ou release), descritas especificamente. Desde 16 de outubro de 2026, a Apple rejeita descrições genéricas de novos recursos.

Pergunte ao usuário apenas: para quem é, a lacuna de mercado com uma contagem de concorrentes datada, testes beta (números de build, datas, feedback que mudou o aplicativo), outros aplicativos na conta e como cada um difere, a empresa que o publica, o próprio site do aplicativo (privacidade, termos, suporte), um login de demonstração e um link de gravação de tela hospedada.

Etapa 2: escreva

Regras para todos os modos:

  • Frases simples, números em vez de adjetivos, datas no formato AAAA-MM-DD.
  • Nunca cole a descrição de marketing da App Store (a pergunta 1 da Apple proíbe).
  • Nomeie todos os outros aplicativos na conta do desenvolvedor e diga em uma linha por que ele é diferente.
  • Liste cada SDK e serviço. Os revisores podem vê-los; omitir um parece pior.
  • Ofereça prova: gravação de tela, arquivos de exemplo, conta de demonstração.
  • Sem alegações que o usuário não confirmou. Deixe [A CONFIRMAR: ...] no lugar.

modelo notes

O QUE FAZ
<2-3 frases, o problema do usuário e o que o aplicativo faz sobre isso>

PARA QUEM É
<grupos nomeados>

COMO TESTAR
Login de demonstração: <email> / <senha> (mantido ativo)
1. <passo para acessar o recurso principal>
2. <passo para acessar o recurso pago> (compra sandbox funciona / código promocional: ...)
Exclusão de conta: Ajustes > <caminho>
Denunciar / Bloquear: <caminho>   (ou: sem conteúdo do usuário)

NOVO NESTA VERSÃO
- <recurso>: <onde está, o que faz>

SERVIÇOS
<auth, pagamentos, analytics, provedor de IA + para que é usado>, nada ativado remotamente após aprovação
Diferenças regionais: nenhuma / <lista>

OUTROS APPS NESTA CONTA
<app>: <uma linha, como difere>   (ou: nenhum)

WEBSITE
<domínio> - privacidade <url>, termos <url>, suporte <email no próprio domínio do app>

Gravação de tela (desde o início, dispositivo físico, iOS mais recente): <link que não requer login>

modelo answer-4.3

Comece com uma linha: você não acha que o aplicativo é spam ou um modelo, e responderá cada pergunta diretamente. Em seguida, nove respostas com cabeçalhos na ordem da Apple:

  1. O que faz 2. Para quem é 3. A lacuna (pesquisa datada, número de concorrentes, avaliações) 4. Testes beta (builds, datas, feedback aplicado) 5. Autônomo ou suíte 6. Compra dentro do aplicativo em outro aplicativo 7. Código compartilhado com seus outros aplicativos 8. Código compartilhado com terceiros 9. Feito para um cliente. Finalize oferecendo uma gravação de tela ou arquivos de exemplo. Responda no App Store Connect; não reenvie a menos que algo realmente tenha mudado.

Se a resposta honesta para 5, 6 ou 7 for "sim, há sobreposição", diga isso ao usuário antes de escrever: a correção é de produto (fundir no aplicativo existente como um recurso, ou torná-lo diferente), não de texto.

modelo packet-2.1

Os seis itens que a Apple pede: gravação de tela, propósito e público, configuração + credenciais + arquivos de exemplo, cada serviço externo, diferenças regionais, documentos de indústria regulamentada. Cole o mesmo texto na resposta do Resolution Center e no campo Notas. Em seguida: deixe o envio como está, no máximo uma consulta de status após duas semanas e segure outros aplicativos até que este seja aprovado.

Lista de gravação: comece na tela inicial de um dispositivo físico com o iOS mais recente, inicie, cadastre-se, faça login, recurso principal, conteúdo do usuário + denunciar/bloquear, compra + conteúdo desbloqueado, excluir conta.

Exemplo

Veja examples/backed-update.md para uma nota real curta que fez uma atualização ser aprovada em 1 minuto.

Etapa 3: verificação pré-envio

Checklist completo e mapa de rejeições: GUIDE.md. Imprima uma lista de aprovado/reprovado: site próprio com privacidade/termos/suporte vinculados no App Store Connect e no aplicativo, e-mail de suporte nesse domínio, login de demonstração testado hoje, exclusão de conta, denunciar/bloquear, cada SDK listado, link de gravação abre sem login, não mais do que alguns aplicativos semelhantes na conta, nova conta = um aplicativo em revisão por vez.

Habilidades Relacionadas