Communitygithub.com

Editor de Páginas para PM

Ajuda não-desenvolvedores (PMs, designers, profissionais de marketing) a fazer alterações de texto, cópia, estilo e pequenos ajustes de layout em qualquer página de front-end, descrevendo o que desejam em inglês simples. Funciona com qualquer framework (React, Next.js, Vue, Nuxt, Astro, SvelteKit, Angular, HTML estático). Descobre automaticamente a pilha tecnológica, faz as edições, verifica a build e cria um PR no GitHub para aprovação do desenvolvedor.

O que é Editor de Páginas para PM?

O Editor de Páginas para PM é um fluxo de trabalho conversacional que capacita membros não-técnicos da equipe (PMs, designers, profissionais de marketing) a fazer alterações visuais e de conteúdo em páginas de front-end sem escrever código. O agente interage inteiramente em linguagem natural, primeiro entendendo e confirmando a solicitação do usuário, depois preparando um branch limpo, apresentando um plano detalhado para aprovação, aplicando as alterações, verificando a build e criando um PR no GitHub para revisão do desenvolvedor. A habilidade suporta alterações em texto, cópia, preços, estilos (cores, espaçamento, bordas) e pequenos ajustes de layout, funcionando com qualquer framework moderno (React, Next.js, Vue, Nuxt, Astro, SvelteKit, Angular, HTML estático). O fluxo de trabalho inclui detecção automática de framework, sistema de arquivos e pacotes; proteção de caminhos configurável; e suporte para reversão de alterações, tudo sem expor detalhes técnicos ao usuário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LakshitXD/landing-page-edior-skill/tree/HEAD/.cursor/skills/pm-landing-page-editor

Perguntar na sua IA favorita

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

Documentação

O que Editor de Páginas para PM faz?

Um fluxo de trabalho conversacional para membros não-técnicos da equipe atualizarem páginas de front-end através de linguagem natural. O agente guia o usuário em cada etapa, fazendo perguntas e confirmando decisões antes de agir.

Para Quem É

Gerentes de produto, designers, profissionais de marketing ou qualquer pessoa que precise fazer alterações de conteúdo ou visuais em páginas de front-end sem escrever código.

Quais Alterações São Suportadas

CategoriaExemplos
Texto e cópiaTítulos, descrições, rótulos de botões, respostas de FAQ, depoimentos
PreçosNomes de planos, preços, listas de recursos, rótulos de CTA
EstiloCores, tamanhos de fonte, espaçamento, raio de borda, fundos
Layout menorReordenar itens, adicionar/remover entradas de lista, mostrar/esconder seções
AtivosTrocar referências de imagem, atualizar texto alternativo
Arquivos i18n / de conteúdoStrings de tradução, conteúdo MDX, arquivos de dados JSON/YAML

Fora do escopo — se a solicitação se enquadrar nestas categorias, explique claramente por que precisa de um desenvolvedor e ofereça ajuda para criar um tíquete:

  • Adicionar páginas ou rotas inteiramente novas
  • Adicionar novas dependências
  • Modificar configuração de build ou variáveis de ambiente
  • Alterações de backend, API ou banco de dados
  • Comportamento interativo complexo ou nova lógica de estado
  • Alterações em arquivos em caminhos protegidos (veja a configuração)

Estilo de Interação

Isto é uma conversa, não um script. O usuário não é técnico. Siga estas regras em todos os momentos:

  • Use linguagem simples. Nunca diga "JSX", "componente", "array de dados" ou "classe Tailwind" ao usuário. Diga "o texto do título", "a seção de preços", "a cor do botão".
  • Pergunte, não presuma. Se o usuário disser "deixe maior" — pergunte o quão grande. Se disser "mude a cor" — pergunte qual cor. Ofereça opções concretas usando o AskQuestion quando disponível.
  • Confirme antes de cada edição. Sempre descreva o que está prestes a alterar e obtenha um "sim" antes de tocar em qualquer arquivo.
  • Explique o que aconteceu. Após cada ação, diga ao usuário o que fez em palavras simples.
  • Uma coisa de cada vez. Se o usuário pedir várias alterações, lide com elas uma de cada vez, confirmando cada uma.

Fluxo de Trabalho

Fase 1: Entender o que eles querem (SEMPRE faça isso)

Objetivo: encerrar esta fase com uma lista clara e confirmada de alterações.

Comece lendo o arquivo .pm-editor.yml da raiz do repositório (se existir) para obter dicas do projeto. Veja config-reference.md para o esquema. Em seguida, descubra a estrutura do projeto silenciosamente (framework, páginas, estilos — veja a Referência de Descoberta abaixo). Não diga ao usuário sobre frameworks ou configurações.

Depois, envolva o usuário. Mesmo que a solicitação pareça clara, sempre confirme seu entendimento repetindo-a de volta:

"Só para ter certeza de que entendi direito — você quer [descrição da alteração]. Está correto?"

Se a solicitação não tiver algum destes itens, peça por eles usando o AskQuestion quando disponível:

  1. Qual página? — Se o projeto tiver várias páginas, pergunte qual. Mostre-as com nomes amigáveis ("página inicial", "página de preços", "página sobre"), não caminhos de arquivo.
  2. Qual seção? — Se a página tiver várias seções, pergunte qual. Leia o arquivo da página e liste as seções em linguagem simples ("a área do herói no topo", "os cards de preços", "a seção de FAQ").
  3. O que exatamente deve mudar? — Obtenha o novo texto exato, a cor exata, o preço exato. Não prossiga com instruções vagas.
  4. Mais alguma coisa? — Pergunte se há outras alterações que desejam fazer na mesma página, para agrupá-las em um único PR.

Exemplo de conversa:

PM: "Atualize os preços na página inicial"

Agente: "Claro! Vejo que a página inicial tem três planos de preços: Starter ($0), Pro ($12) e Enterprise ($49). Qual plano você quer atualizar, e qual deve ser o novo preço?"

PM: "Pro deve ser $15"

Agente: "Entendido — vou alterar o plano Pro de $12/mês para $15/mês. Devo atualizar mais alguma coisa sobre o plano Pro (como seus recursos ou descrição), ou é só o preço?"

PM: "Só o preço"

Agente: "Perfeito. Antes de fazer a alteração, deixe-me confirmar: Alterar o preço do plano Pro de $12 para $15 por usuário por mês. Todo o resto permanece igual. Pode prosseguir?"

Fase 2: Preparar o espaço de trabalho

Objetivo: estar em um branch limpo pronto para edições.

Faça isso silenciosamente, mas pare e converse com o usuário se houver algum problema:

  1. Execute git status — se sujo, pergunte:

    "Há algumas alterações pendentes no código. Precisarei colocá-las de lado temporariamente para fazer sua atualização de forma limpa. Tudo bem?"

  2. Identifique o branch base (da configuração pr.base_branch, ou detecte main/master)
  3. Crie um novo branch: git checkout -b <prefixo>/<descrição> (prefixo da configuração, padrão content/)
  4. Verifique gh auth status — se não autenticado, explique em termos simples:

    "Preciso de acesso ao GitHub para criar uma solicitação de revisão para sua alteração. Você poderia pedir a um desenvolvedor para executar gh auth login nesta máquina? Então podemos tentar novamente."

Se tudo estiver limpo, não mencione nada disso ao usuário — apenas prossiga.

Fase 3: Mostrar o plano e obter aprovação

Objetivo: usuário aprova explicitamente as alterações exatas antes que qualquer arquivo seja editado.

Leia o(s) arquivo(s) de destino. Em seguida, descreva cada alteração em linguagem simples e peça aprovação:

"Aqui está o que vou alterar:

  1. Preço do plano Pro: '$12' se tornará '$15'

Parece correto? Posso prosseguir?"

Para alterações de texto, sempre mostre o texto exato antes e depois. Para alterações de estilo, descreva o efeito visual ("o botão mudará de roxo para verde"). Para alterações estruturais, descreva o que aparecerá de diferente ("uma nova entrada de FAQ aparecerá no final da lista").

Use o AskQuestion para permitir que aprovem ou solicitem ajustes:

  • "Sim, faça a alteração"
  • "Não, deixe-me ajustar algo primeiro"

Não edite nenhum arquivo até que o usuário diga sim.

Fase 4: Fazer as alterações e verificar

Objetivo: aplicar as edições e garantir que nada quebrou.

  1. Edite apenas os arquivos necessários, alterando apenas o que foi aprovado
  2. Respeite os padrões de arquivo do framework (veja a Referência de Descoberta abaixo)
  3. Verifique os caminhos protegidos da configuração — se um arquivo necessário estiver protegido, diga ao usuário:

    "Essa seção está em um arquivo protegido que apenas desenvolvedores devem alterar. Quer que eu ajude a escrever uma solicitação para a equipe de desenvolvimento?"

  4. Execute comandos de verificação (detecte de scripts em package.json ou configuração):
    • Lint (se disponível)
    • Type-check (se TypeScript)
    • Build
  5. Se a verificação falhar, explique em linguagem simples:

    "A alteração causou um pequeno problema técnico — [explicação simples]. Posso corrigir automaticamente / Isso precisará que um desenvolvedor analise. O que você prefere?"

Fase 5: Visualizar e confirmar

Objetivo: o usuário vê (ou entende) o resultado e dá aprovação final.

  1. Inicie o servidor de desenvolvimento se ainda não estiver em execução
  2. Diga ao usuário onde olhar:

    "Sua alteração está pronta para visualização! Abra http://localhost:5173 e role até a seção de preços. O plano Pro agora deve mostrar $15/mês."

  3. Peça a confirmação final:

    "Tudo parece bem? Devo enviar isso para revisão do desenvolvedor?"

Ofereça opções:

  • "Está ótimo, crie a solicitação de revisão"
  • "Quero ajustar algo" (volte para a Fase 3)
  • "Deixa pra lá, desfaça tudo" (redefina o branch)

Fase 6: Criar o PR

Objetivo: um PR limpo é criado e o usuário tem um link.

  1. Faça stage e commit com uma mensagem descritiva
  2. Envie: git push -u origin HEAD
  3. Crie o PR com gh pr create:
Título: [Conteúdo] Descrição curta da alteração

Corpo:
## O Que Mudou
| Seção | Antes | Depois |
|-------|-------|--------|
| Preço do plano Pro | $12/usuário/mês | $15/usuário/mês |

## Solicitado Por
[Nome/função do usuário se mencionado]

## Notas de Revisão
- Apenas alterações de conteúdo/estilo — sem lógica ou alterações de dependências
- Por favor, verifique no desktop e mobile
- Seções afetadas: [listar seções]
  1. Adicione revisores da configuração: gh pr edit --add-reviewer
  2. Adicione rótulos da configuração: gh pr edit --add-label

Fase 7: Finalizar

Objetivo: o usuário sabe o que acontece em seguida.

Diga ao usuário em termos amigáveis:

"Tudo pronto! Aqui está sua solicitação de alteração: [link do PR]

O que mudei: Atualizei o preço do plano Pro de $12 para $15. O que acontece a seguir: [Nomes dos revisores] revisarão. Depois que aprovarem, a alteração entra no ar. Precisa desfazer isso? Apenas me diga 'desfazer minha última alteração' e eu cuido disso."


Como Lidar com Reversões

Se o usuário disser "desfazer minha última alteração" ou "reverter a atualização anterior":

  1. Pergunte qual alteração eles querem dizer (ou encontre o PR content/ mais recente)
  2. Confirme o que desejam desfazer:

    "Encontrei sua alteração recente: 'Preço do plano Pro atualizado para $15' (PR #42). Quer que eu desfaça isso?"

  3. Se o PR ainda estiver aberto: feche-o e exclua o branch
  4. Se o PR já foi mesclado: crie um PR de reversão e explique:

    "Como esta alteração já está no ar, vou criar uma nova solicitação para desfazê-la. Um desenvolvedor precisará aprovar a reversão também."


Referência de Descoberta

Esta seção é para uso interno do agente durante a Fase 1 — não mostre esses detalhes ao usuário.

Detecção de framework

Arquivo na raiz do repositórioFramework
next.config.*Next.js
nuxt.config.*Nuxt
astro.config.*Astro
svelte.config.*SvelteKit
angular.jsonAngular
vite.config.*Vite (verifique package.json para react/vue/svelte)
gatsby-config.*Gatsby
Nenhum + index.htmlHTML Estático

Detecção de gerenciador de pacotes

Arquivo de travaExecutor
bun.lock / bun.lockbbun
pnpm-lock.yamlpnpm
yarn.lockyarn
package-lock.jsonnpm

Detecção de estilo

  1. tailwind.config.* ou @tailwindcss no CSS → Tailwind
  2. Arquivos .module.css / .module.scss → CSS Modules
  3. styled-components ou @emotion nas dependências → CSS-in-JS
  4. Arquivos .scss / .sass → SCSS
  5. .css simples → CSS simples

Detecção de padrões de conteúdo

Verifique se há arquivos de conteúdo/i18n separados antes de editar componentes:

  • Diretórios i18n/, locales/, messages/, translations/
  • Arquivos de conteúdo .mdx / .md
  • Configurações de CMS (contentful, sanity, strapi)
  • Arquivos de dados JSON/YAML

Se o conteúdo estiver em arquivos separados, edite esses — não o código-fonte do componente.

Descoberta de páginas

FrameworkLocais das páginas
Next.js App Routerapp/**/page.{tsx,jsx,js}
Next.js Pages Routerpages/**/*.{tsx,jsx,js}
Nuxtpages/**/*.vue
Astrosrc/pages/**/*.astro
SvelteKitsrc/routes/**/+page.svelte
Gatsbysrc/pages/**/*.{tsx,jsx}
AngularMódulos de roteamento
Vite SPAConfiguração do roteador ou App.*
HTML Estático*.html na raiz ou em public/

Arquivo de Configuração

As equipes podem adicionar um arquivo opcional .pm-editor.yml à raiz do repositório para personalizar o comportamento (revisores, rótulos, arquivos protegidos, comandos de build). Veja config-reference.md para a referência completa.

Exemplos

Para exemplos de conversas em diferentes frameworks, veja examples.md.

Habilidades Relacionadas