CommunityRedacción y edicióngithub.com

Redacción de investigación científica

Útil para redactar, revisar o corregir una sección de un artículo de investigación de revista, desde el título hasta la conclusión. También para artículos dirigidos a una revista objetivo (deriva su modelo de artículos de muestra) y para mantener el perfil de estilo del autor.

¿Qué es Redacción de investigación científica?

Esta habilidad ('skill') para agentes de IA (Claude, Codex, etc.) asiste a autores (nativos o no nativos) en la redacción, revisión o corrección de una sección específica de un artículo de investigación de revista, desde el título hasta la discusión. No está diseñada para propuestas de financiación, cartas de presentación, réplicas, tesis o artículos de revisión. Su núcleo es un motor de pasos (`engine.py`) que orquesta el flujo de trabajo: el agente ejecuta cada paso (redactar, revisar, preguntar al autor) y envía el resultado al motor para validación. El agente debe aplicar las reglas de integridad (no inventar resultados, citas o detalles) y el perfil de estilo del autor (almacenado localmente en `~/.agents/...`). Admite los modos 'draft' (notas/esquemas) y 'revise' (párrafos completos), y permite incluir artículos de muestra de la revista objetivo para modelar el estilo. También gestiona perfiles de autor y preferencias (como 'siempre usar nosotros'). En caso de faltar Python3, se proporciona un flujo de trabajo manual alternativo ('fallback') basado en archivos de referencia y verificación visual de reglas. En resumen, es una herramienta estructurada que externaliza el proceso de escritura académica a un agente, garantizando coherencia, respeto por las normas de la revista y fidelidad al estilo del autor.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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.

  1. 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; start no 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. Usa other para 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. Usa whole-paper para 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. Con codex, el motor se ofrece a instalar el gancho de guardia de Codex (un paso setup); other significa 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 --input la muestra de escritura) y --task study-profile inician las dos tareas de perfil en su lugar. Antes de guardar una preferencia, escanear, estudiar o manejar un conflicto, lee references/style-profile.md.
    • Si tu lectura y la del código difieren (por ejemplo, pasas --section methods pero el encabezado del texto dice Introducción), el motor devuelve un paso ask (id clarify). Nunca lo resuelvas tú mismo.
  2. 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).
  3. Cada respuesta es un paso. Lee cada archivo en read por completo (el perfil del autor, ~/.agents/science-research-writing/user-style.md, se lista cuando existe: aplícalo a todo), haz lo que dice instruction, y escribe tu resultado como el JSON en expect. El texto extenso va en un archivo; da su ruta. Un paso ask es una pregunta para el autor: pon context.question palabra por palabra, espera la respuesta, y envíala como {"answer": ...} con una de context.options. Nunca respondas tú mismo.
  4. 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 un error significa que se devuelve el mismo paso: corrígelo y vuelve a enviarlo.
  5. Repite hasta que step.kind sea done. Luego muestra output al 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.md indica 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 exceptions del 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.

Skills relacionados