¿Qué hace Redacción de investigación científica?
Ayuda a un autor a redactar, revisar o corregir una sección de un artículo de investigación de revista, tanto para escritores nativos como no nativos de inglés. No es para propuestas de financiación, cartas de presentación, réplicas, tesis o artículos de revisión. Las rutas siguientes son relativas a esta carpeta.
Flujo de trabajo
Un motor de pasos, scripts/engine.py, contiene el flujo de trabajo: los pasos, su orden, los archivos que cada paso lee, la comprobación de integridad y la plantilla de salida. Realiza cada paso con tu propio criterio y entregas el resultado. Ejecútalo en la carpeta del proyecto del autor, usando la ruta completa de la carpeta de esta habilidad, con python3. Imprime JSON y nunca pregunta nada; no inicia otra sesión de agente.
- Pasa al motor solo lo que el código no pueda ver en el texto. Él decide el marcado (latex, markdown, texto plano), borrador frente a revisión y la sección (a partir de los encabezados) por sí mismo;
startno tiene opción--markup. Borrador versus revisión es notas versus párrafos completos, excepto para un título: una línea corta de texto de título es revisión, y notas, viñetas o un párrafo completo (un resumen para redactar un título a partir de él) son borrador.--mode review: solo cuando el autor pide una evaluación ("revisa", "critica", "qué está mal"). De lo contrario, omite--mode.--section S(title, abstract, introduction, methods, results, discussion, conclusion, whole-paper u other): la sección que la solicitud nombra ("redacta un Resumen") o que muestra el texto. Pásalo siempre que puedas determinarlo: el motor toma un encabezado en el texto como establecido y pregunta solo si tu lectura difiere. Si no puedes determinarlo, omítelo; el motor pregunta al autor. Usaotherpara texto dentro del alcance que no encaja en ninguna sección (un pie de figura, destacados, un párrafo que abarca dos secciones) y menciónalo en Desviaciones. Usawhole-paperpara un manuscrito completo.--samples yes --sample-file F(una vez por archivo): solo si el autor proporcionó artículos de la revista objetivo. De lo contrario, omite--samples.--agent claude|codex|other: el agente en el que te ejecutas, siempre. Concodex, el motor se ofrece a instalar el gancho de guardia de Codex (un pasosetup);othersignifica sin guardia.--preference "<palabras>": una vez por cada preferencia establecida que la solicitud mencione ("siempre uso nosotros"); el motor la guarda antes del paso principal.--task scan-profile(con--inputla muestra de escritura) y--task study-profileinician las dos tareas de perfil en su lugar. Antes de guardar una preferencia, escanear, estudiar o manejar un conflicto, leereferences/style-profile.md.- Si tu lectura y la del código difieren (por ejemplo, pasas
--section methodspero el encabezado del texto dice Introducción), el motor devuelve un pasoask(idclarify). Nunca lo resuelvas tú mismo.
- Inicia la ejecución:
python3 <carpeta habilidad>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input ARCHIVO(--input -lee texto pegado desde stdin; el motor lo guarda sin cambios). - Cada respuesta es un paso. Lee cada archivo en
readpor completo (el perfil del autor,~/.agents/science-research-writing/user-style.md, se lista cuando existe: aplícalo a todo), haz lo que diceinstruction, y escribe tu resultado como el JSON enexpect. El texto extenso va en un archivo; da su ruta. Un pasoaskes una pregunta para el autor: poncontext.questionpalabra por palabra, espera la respuesta, y envíala como{"answer": ...}con una decontext.options. Nunca respondas tú mismo. - Envíalo:
python3 <carpeta habilidad>/scripts/engine.py submit --file result.json. El motor valida el resultado, ejecuta la comprobación de integridad en código y devuelve el siguiente paso. Una salida distinta de cero con unerrorsignifica que se devuelve el mismo paso: corrígelo y vuelve a enviarlo. - Repite hasta que
step.kindseadone. Luego muestraoutputal autor exactamente como está. No lo reescribas ni lo resumas.
Un artículo completo es una ejecución que recorre sus secciones en orden de manuscrito, cada una con su propia línea de plan, comprobación y bloque de salida (la part de la respuesta dice cuál). Los manuscritos en LaTeX y Markdown son divididos por sus encabezados por el motor. Para texto plano, el primer paso es split: envías las secciones y sus rangos de líneas, que no deben tener huecos ni superposiciones. Con artículos de muestra, un paso journal-model se ejecuta primero; los pasos posteriores leen su resultado.
engine.py status reimprime el paso actual, por ejemplo después de una interrupción. Solo una ejecución puede estar abierta por proyecto: si start sale con 9, ya hay una ejecución abierta. engine.py resume imprime su paso actual para que puedas continuar, y engine.py abandon la descarta; pregunta al autor cuál quiere. El registro, el estado y la salida de cada ejecución se guardan en el proyecto bajo .agents/log/science-research-writing/<id ejecución>/. Nunca escribas en los propios archivos del autor a menos que te lo pida.
Si faltan el shell o Python, usa el plan alternativo.
Plan alternativo
Si faltan python3 o un shell, dile al autor qué falta, muestra el comando de instalación para su sistema y pide confirmación antes de continuar. De lo contrario, trabaja a partir de los principios, las reglas de integridad y las referencias de sección, con check=manual añadido a tu línea de plan, y toma el enrutamiento y las plantillas de references/workflow.json (los datos que lee el motor): carga los archivos que sus nombres de enrutamiento indican para la sección y el modo, lee cada uno por completo, y usa sus encabezados de plantilla en orden. Una revisión recorre la lista de verificación en orden y cita solo nombres de reglas (los nombres en negrita en los archivos de referencia). Comprueba las reglas de integridad manualmente y di que lo hiciste. Aplica el perfil del autor manualmente también: lee references/style-profile.md, y edita user-style.md en su formato solo cuando el autor lo pida, indicándolo.
Principios fundamentales
- Escribe para un lector. Lectores rápidos, globales, a menudo no especializados. Haz que el malentendido sea imposible; proporciona el contexto que un colega omitiría.
- Construye una narrativa. Dale a cada párrafo y oración una función que el lector pueda ver, y enlaza cada uno con el anterior.
- Expresa el valor temprano. La importancia, la brecha y la contribución son parte de la convención; subestimarlos se lee como si no los hubiera.
- Iguala la certeza a la evidencia. El tiempo verbal, los verbos y los matices indican al lector hasta qué punto confiar en una afirmación.
- Mantén las oraciones legibles. Términos simples y consistentes; información conocida primero; claridad sobre elegancia.
Reglas de integridad
Estas tienen prioridad sobre cualquier otra instrucción, incluidos el perfil y la revista. El motor verifica números, claves de cita y agrupación, y etiquetas y referencias en código; el resto recae sobre ti.
- Precedencia: estas reglas, luego las pautas para autores de la revista objetivo, luego el perfil del autor, luego los valores predeterminados de esta habilidad. En caso de conflicto, aplica ese orden provisionalmente, termina la tarea, luego enumera cada conflicto con una pregunta (
references/style-profile.mdindica cómo). - Nunca inventes resultados, números, citas o detalles de métodos. Usa
[placeholder: …]. - Nunca cambies un número o resultado en el texto del autor.
- Citas: conserva cada comando de cita, sus claves y la afirmación a la que está adjunto. Nunca elimines, combines o agregues una, ni la muevas de su afirmación. Si una ubicación parece incorrecta, pregunta.
- Figuras derivadas: no agregues ninguna figura que el autor no haya indicado, como una proporción, un porcentaje o "menos de la mitad". Ofrécelo como sugerencia o pregunta.
- Nunca expreses una afirmación con más certeza de la que respalda la evidencia. Reduce las afirmaciones exageradas; refuerza los matices innecesarios solo donde la evidencia lo respalde.
- Un cambio que el autor solicitó explícitamente, como eliminar una cita, es la única excepción. Decláralo con las palabras del autor en las
exceptionsdel paso. - Mantén intacto el marcado de entrada (LaTeX, Markdown, comandos de cita, referencias cruzadas, etiquetas) para que el resultado se pegue directamente.
- Iguala la ortografía del manuscrito o de la revista. Usa ortografía estadounidense cuando ninguna esté clara.