CommunityEscrita e Ediçãogithub.com

Redação Científica

Auxilia na redação, revisão ou avaliação de seções de artigos de pesquisa para periódicos, com suporte a perfis de estilo e modelos de periódicos alvo.

O que é Redação Científica?

Esta skill foi projetada para auxiliar autores nativos ou não nativos de inglês na redação, revisão ou avaliação de uma seção de um artigo de pesquisa para periódicos científicos. Ela é ideal para títulos, resumos, introduções, métodos, resultados, discussões, conclusões ou manuscritos completos, mas não se aplica a propostas de financiamento, cartas de apresentação, réplicas, teses ou artigos de revisão. A skill utiliza um mecanismo de etapas (engine) baseado em Python que gerencia o fluxo de trabalho de forma autônoma, lendo arquivos, verificando integridade e gerando templates. O autor interage fornecendo preferências de estilo e amostras de artigos do periódico alvo, enquanto o agente (Claude, Codex ou outro) executa cada etapa conforme instruções detalhadas. A skill prioriza a integridade dos dados (números, citações, resultados) e segue regras rígidas, como nunca inventar informações ou alterar dados do autor. Suporta fallback manual caso o Python não esteja disponível, e é compatível com os agentes Claude, Codex e outros, com suporte a guard hooks para Codex. O resultado é um texto refinado e coerente, pronto para ser inserido diretamente no manuscrito.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SJ2050cn/science-research-writing/tree/master

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que Redação Científica faz?

Auxilia um autor a redigir, revisar ou avaliar uma seção de um artigo de pesquisa para periódicos, voltado para escritores nativos e não nativos de inglês. Não é adequado para propostas de financiamento, cartas de apresentação, réplicas, teses ou artigos de revisão. Os caminhos abaixo são relativos a esta pasta.

Fluxo de Trabalho

Um mecanismo de etapas, scripts/engine.py, gerencia o fluxo de trabalho: as etapas, sua ordem, os arquivos que cada etapa lê, a verificação de integridade e o template de saída. Você executa cada etapa com seu próprio julgamento e entrega o resultado. Execute-o na pasta do projeto do autor, usando o caminho completo da pasta desta skill, com python3. Ele imprime JSON e nunca pergunta nada; não inicia outra sessão de agente.

  1. Passe ao mecanismo apenas o que o código não consegue ver no texto. Ele decide a marcação (latex, markdown, texto simples), rascunho versus revisão e a seção (a partir dos cabeçalhos) por conta própria; start não tem opção --markup. Rascunho versus revisão é anotações versus parágrafos completos, exceto para um título: uma linha curta de texto de título é revisão, e anotações, marcadores ou um parágrafo completo (um resumo para redigir um título a partir dele) são rascunho.
    • --mode review: somente quando o autor solicitar uma avaliação ("verifique", "critique", "o que está errado"). Caso contrário, omita --mode.
    • --section S (title, abstract, introduction, methods, results, discussion, conclusion, whole-paper ou other): a seção que a solicitação nomeia ("redija um Resumo") ou que o texto mostra. Sempre passe quando você puder identificar: o mecanismo considera um cabeçalho no texto como definido e pergunta apenas se sua leitura for diferente. Se não puder identificar, omita; o mecanismo pergunta ao autor. Use other para texto dentro do escopo que não se encaixa em nenhuma seção (uma legenda de figura, destaques, um parágrafo que abrange duas seções) e informe isso em Desvios. Use whole-paper para um manuscrito completo.
    • --samples yes --sample-file F (uma vez por arquivo): somente se o autor forneceu artigos do periódico alvo. Caso contrário, omita --samples.
    • --agent claude|codex|other: o agente em que você está executando, sempre. Com codex o mecanismo oferece instalar o gancho de guarda do Codex (uma etapa setup); other significa sem guarda.
    • --preference "<palavras>": uma vez para cada preferência permanente que a solicitação declarar ("Eu sempre uso nós"); o mecanismo a salva antes da etapa principal. --task scan-profile (com --input como a amostra de escrita) e --task study-profile iniciam as duas tarefas de perfil. Antes de salvar uma preferência, escanear, estudar ou lidar com um conflito, leia references/style-profile.md.
    • Se sua leitura e a do código divergirem (por exemplo, você passa --section methods mas o cabeçalho do texto diz Introduction), o mecanismo retorna uma etapa ask (id clarify). Nunca resolva isso sozinho.
  2. Inicie a execução: python3 <pasta da skill>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE (--input - lê texto colado da entrada padrão; o mecanismo o salva inalterado).
  3. Cada resposta é uma etapa. Leia cada arquivo em read por completo (o perfil do autor, ~/.agents/science-research-writing/user-style.md, é listado quando existe: aplique-o a tudo), faça o que instruction diz e escreva seu resultado como o JSON em expect. Texto longo vai em um arquivo; informe seu caminho. Uma etapa ask é uma pergunta para o autor: coloque context.question para ele palavra por palavra, aguarde a resposta e a submeta como {"answer": ...} com uma das context.options. Nunca responda sozinho.
  4. Submeta: python3 <pasta da skill>/scripts/engine.py submit --file result.json. O mecanismo valida o resultado, executa a verificação de integridade no código e retorna a próxima etapa. Uma saída não zero com um error significa que a mesma etapa é retornada: corrija e reenvie.
  5. Repita até que step.kind seja done. Então mostre output ao autor exatamente como está. Não reescreva ou resuma.

Um artigo completo é uma execução que percorre suas seções na ordem do manuscrito, cada uma com sua própria linha de planejamento, verificação e bloco de saída (o part da resposta indica qual). Manuscritos em LaTeX e Markdown são divididos em seus cabeçalhos pelo mecanismo. Para texto simples, a primeira etapa é split: você submete as seções e seus intervalos de linhas, que não devem ter lacunas nem sobreposições. Com artigos de amostra, uma etapa journal-model é executada primeiro; as etapas seguintes leem seu resultado.

engine.py status reimprime a etapa atual, por exemplo após uma interrupção. Apenas uma execução pode estar aberta por projeto: se start sair com código 9, uma execução já está aberta. engine.py resume imprime a etapa atual para que você possa continuar, e engine.py abandon a descarta; pergunte ao autor qual ele prefere. Log, estado e saída de cada execução são mantidos no projeto sob .agents/log/science-research-writing/<id da execução>/. Nunca escreva nos próprios arquivos do autor a menos que solicitado.

Se o shell ou Python estiver faltando, use o fallback.

Fallback

Se python3 ou um shell estiver faltando, informe ao autor o que está faltando, mostre o comando de instalação para o sistema dele e peça antes de continuar. Caso contrário, trabalhe a partir dos princípios, das regras de integridade e das referências de seção, com check=manual adicionado à sua linha de planejamento, e obtenha roteamento e templates de references/workflow.json (os dados que o mecanismo lê): carregue os arquivos que seus nomes de roteamento indicam para a seção e modo, leia cada um por completo e use seus cabeçalhos de template em ordem. Uma revisão percorre a lista de verificação em ordem e cita apenas nomes de regras (os nomes em negrito nos arquivos de referência). Verifique as regras de integridade manualmente e informe que o fez. Aplique o perfil do autor manualmente também: leia references/style-profile.md e edite user-style.md em seu formato apenas quando o autor solicitar, informando isso.

Princípios fundamentais

  1. Escreva para um leitor. Leitores rápidos, globais, frequentemente não especialistas. Torne o mal-entendido impossível; forneça o contexto que um colega ignoraria.
  2. Construa uma narrativa. Dê a cada parágrafo e frase uma função que o leitor possa ver e ligue cada um ao anterior.
  3. Declare o valor cedo. Importância, lacuna e contribuição fazem parte da convenção; subestimar soa como não ter nenhuma.
  4. Combine certeza com evidência. Tempo verbal, verbos e atenuações informam ao leitor o quanto confiar em uma afirmação.
  5. Mantenha as frases legíveis. Termos simples e consistentes; informação conhecida primeiro; clareza sobre elegância.

Regras de integridade

Estas prevalecem sobre qualquer outra instrução, incluindo o perfil e o periódico. O mecanismo verifica números, chaves de citação e agrupamento, e rótulos e referências no código; o resto depende de você.

  • Precedência: estas regras, depois as diretrizes do periódico alvo, depois o perfil do autor, depois os padrões desta skill. Em caso de conflito, aplique essa ordem provisoriamente, conclua a tarefa e então liste cada conflito com uma pergunta (references/style-profile.md explica como).
  • Nunca invente resultados, números, citações ou detalhes de método. Use [placeholder: …].
  • Nunca altere um número ou resultado no texto do autor.
  • Citações: mantenha todos os comandos de citação, suas chaves e a afirmação à qual estão ligados. Nunca remova, mescle ou adicione um, ou mova um para longe de sua afirmação. Se um posicionamento parecer errado, pergunte.
  • Figuras derivadas: não adicione figuras que o autor não declarou, como uma razão, uma porcentagem ou "menos da metade". Ofereça como sugestão ou pergunta.
  • Nunca declare uma afirmação com mais certeza do que sua evidência suporta. Reduza afirmações exageradas; fortaleça atenuações desnecessárias apenas onde a evidência as suporta.
  • Uma alteração que o autor solicitou explicitamente, como excluir uma citação, é a única exceção. Declare-a com as palavras do autor na etapa exceptions.
  • Mantenha a marcação da entrada (LaTeX, Markdown, comandos de citação, referências cruzadas, rótulos) intacta para que o resultado seja colado diretamente de volta.
  • Corresponda à ortografia do manuscrito ou do periódico. Use ortografia americana quando nenhum dos dois estiver claro.

Habilidades Relacionadas