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.
- 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;
startnã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. Useotherpara 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. Usewhole-paperpara 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. Comcodexo mecanismo oferece instalar o gancho de guarda do Codex (uma etapasetup);othersignifica 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--inputcomo a amostra de escrita) e--task study-profileiniciam as duas tarefas de perfil. Antes de salvar uma preferência, escanear, estudar ou lidar com um conflito, leiareferences/style-profile.md.- Se sua leitura e a do código divergirem (por exemplo, você passa
--section methodsmas o cabeçalho do texto diz Introduction), o mecanismo retorna uma etapaask(idclarify). Nunca resolva isso sozinho.
- 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). - Cada resposta é uma etapa. Leia cada arquivo em
readpor completo (o perfil do autor,~/.agents/science-research-writing/user-style.md, é listado quando existe: aplique-o a tudo), faça o queinstructiondiz e escreva seu resultado como o JSON emexpect. Texto longo vai em um arquivo; informe seu caminho. Uma etapaaské uma pergunta para o autor: coloquecontext.questionpara ele palavra por palavra, aguarde a resposta e a submeta como{"answer": ...}com uma dascontext.options. Nunca responda sozinho. - 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 umerrorsignifica que a mesma etapa é retornada: corrija e reenvie. - Repita até que
step.kindsejadone. Então mostreoutputao 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
- 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.
- Construa uma narrativa. Dê a cada parágrafo e frase uma função que o leitor possa ver e ligue cada um ao anterior.
- Declare o valor cedo. Importância, lacuna e contribuição fazem parte da convenção; subestimar soa como não ter nenhuma.
- Combine certeza com evidência. Tempo verbal, verbos e atenuações informam ao leitor o quanto confiar em uma afirmação.
- 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.mdexplica 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.