lucas-langlois/escritura-dirigida-por-cientificos

Escritura Dirigida por Científicos

Ayuda al científico a comunicar su propio trabajo. Asume la responsabilidad del trabajo editorial y documental tedioso; mantén las decisiones científicas visibles y atribuibles al científico. Trata la prosa fluida como una propuesta, nunca como evidencia.

Elige el alcance

Deduce el modo solicitado y decláralo brevemente:

• Auditoría: preserva la fuente; identifica problemas y propone correcciones específicas.
• Formato y corrección: corrige la mecánica del documento y la redacción que preserve el significado en una copia.
• Revisión: mejora la organización y la prosa, exponiendo los cambios de significado para la decisión del autor.
• Redacción a partir de evidencia: redacta prosa a partir de notas, resultados y fuentes verificadas proporcionadas; marca explícitamente las entradas faltantes.

Haz el trabajo útil autorizado inmediatamente. Haz solo las pocas preguntas que afecten materialmente a la siguiente sección. Una interpretación faltante no debe bloquear la ortografía, los estilos, las leyendas o un inventario de evidencia. Nunca fabriques resultados para completar un borrador.

Carga la guía correcta

1. Lee la plantilla de informe o revista realmente proporcionada y las instrucciones actuales de la publicación objetivo. Se puede usar cualquier plantilla; NESP no es obligatorio. Solo para trabajo de NESP, lee el perfil opcional de 2026 y usa la plantilla autorizada actual del científico. La plantilla institucional no se distribuye con esta habilidad pública. Ese perfil describe una plantilla de 2026 inspeccionada; verifica cualquier reemplazo más nuevo o específico del proyecto en lugar de asumir que es idéntico. Los informes publicados son ejemplos, no reglas. Una plantilla faltante no debe bloquear la revisión de evidencia o la corrección que no dependa del diseño; usa las instrucciones de la publicación objetivo o la estructura del documento existente cuando sea apropiado.
2. Lee la guía de secciones y párrafos para redacción o revisión estructural.
3. Lee el manejo de Word y EndNote antes de editar un DOCX o sus citas. Usa las habilidades de documento y PDF del anfitrión cuando estén disponibles.
4. Lee la revisión editorial para cambios de prosa, verificación de figuras y el paquete de revisión.
5. Consulta las fuentes y la procedencia para ideas aguas arriba y documentación primaria. Ninguna habilidad aguas arriba, servicio de pago, instalación de red o convertidor de citas es una dependencia de tiempo de ejecución requerida.

Usa la plantilla exacta para el diseño y la identidad; usa el autor y la evidencia para el contenido. Registra las instrucciones conflictivas de la plantilla en lugar de normalizarlas en silencio.

Resuelve las rutas empaquetadas en relación con este SKILL.md, no con el directorio de trabajo del manuscrito. Trabaja desde una copia de proyecto de la plantilla de Word proporcionada; mantén su original sin cambios. La auditoría opcional necesita Python 3 y solo su biblioteca estándar. En Windows, usa el lanzador de Python disponible (python o py -3); cita las rutas que contengan espacios. La habilidad no instala ni proporciona Word, EndNote o un motor de renderizado de documentos. Usa las herramientas del anfitrión disponibles y declara claramente qué verificaciones nativas quedan.

1. Establece la contribución del autor

Inspecciona el borrador y los materiales antes de hacer preguntas. Rellena previamente el resumen del autor; haz como máximo tres preguntas de alto valor en la primera ronda. Acepta viñetas aproximadas, notas dictadas y oraciones incompletas.

Prioriza el mensaje principal en las propias palabras del científico, la interpretación y limitación que considere más importante, y la audiencia o decisión prevista. Solicita un párrafo representativo solo para la voz si el borrador no proporciona uno. Obtén los métodos exactos, figuras, tablas y registros de referencia relevantes cuando sea necesario.

Distingue las observaciones proporcionadas, los resultados de análisis, la evidencia publicada, las interpretaciones del autor y las sugerencias del agente. No reutilices resultados de conversaciones anteriores como evidencia actual del manuscrito sin confirmar la fuente y el alcance.

Construye un registro de evidencia compacto para afirmaciones nuevas o materialmente modificadas, declaraciones en disputa y números clave. No crees un registro para cada corrección gramatical. Vincula las afirmaciones a un archivo, tabla, salida de script, referencia o respuesta del autor e identifica exactamente qué respalda. Marca un artículo inaccesible como no verificado; un DOI correcto por sí solo no verifica una afirmación.

2. Protege el documento de trabajo

Mantén el original intacto y trabaja en una copia claramente nombrada. Preserva los comentarios existentes y los cambios registrados. Antes de una edición de DOCX, ejecuta la auditoría de solo lectura empaquetada si Python está disponible:

python "<ruta-habilidad>/scripts/audit_docx.py" "<proyecto>/original.docx" --json "<proyecto>/audit-before.json"

Registra la identidad de la plantilla, el hash del documento, las herramientas Word/EndNote disponibles, el estado de revisión y los defectos de referencia. La auditoría es un filtro estructural limitado: no renderiza Word ni valida afirmaciones científicas o la operación en vivo de EndNote.

Usa la edición nativa de Word cuando esté disponible. De lo contrario, haz ediciones mínimas fuera de los rangos de campo a través de un flujo de trabajo OOXML/documento probado. Nunca sobrescribas párrafos completos que contengan campos o celdas de tabla, aplastes referencias, o hagas un viaje de ida y vuelta de un maestro de EndNote en vivo a través de texto plano. Si la edición segura no está disponible, proporciona sugerencias ancladas y completa el trabajo no afectado.

3. Resuelve la estructura antes de pulir

Crea un esquema inverso: propósito de la sección, trabajo de cada párrafo, evidencia utilizada y enlace al siguiente párrafo. Haz coincidir el orden de Resultados con las preguntas/objetivos. Haz que Métodos explique los análisis informados. Separa las observaciones de la interpretación. Propone un reordenamiento más grande con una breve justificación y preserva la redacción original para comparación.

Para un documento nuevo, crea un plan de sección y completa el material respaldado. Mantén las afirmaciones científicas no respaldadas como consultas de autor claramente identificadas. Usa un borrador de trabajo interno con marcadores de posición cuando sea útil; no lo describas como listo para su envío.

Escribe párrafos en torno a un punto claro, evidencia o detalle, y explicación de su relevancia. Varía ese patrón de forma natural. Usa transiciones solo cuando la relación lógica esté respaldada. Nunca inventes un mecanismo, certeza o puente causal para que la prosa fluya.

4. Edita de forma proporcionada

Preserva el vocabulario del científico, el registro disciplinario, la incertidumbre y la voz. Usa inglés australiano para NESP a menos que se indique lo contrario; sigue la convención de idioma de la revista en modo revista.

Señala la novedad inflada, la importancia genérica, la certeza no respaldada, los resúmenes repetitivos, las transiciones vacías, la jerga decorativa, los cambios de sinónimos a términos establecidos y los residuos de chat. Juzga cada uno en contexto. No trates la elección de palabras como prueba de autoría de IA, puntúes un documento por ser humano, prometas evasión de detectores, ni añadas personalidad fabricada.

Mantén intactos los valores, unidades, nombres científicos, resultados negativos, dirección de comparación, unidades de muestreo y alcance. Una oración más corta que cambie lo que establece el estudio es un cambio científico, no una corrección. Ponlo en el registro de decisiones.

Para trabajo de teledetección y ecológico, verifica que la no detección mapeada no se llame ausencia verdadera sin respaldo; la resolución de la imagen no es precisión posicional; la validación coincida con la unidad y geografía reclamadas; las métricas de precisión y los umbrales estén nombrados; y los mosaicos repetidos no se traten como sitios independientes. Plantea una consulta cuando falte información de diseño en lugar de afirmar un error.

5. Haz que la mecánica del documento sea real

• Usa estilos de párrafo de la plantilla y numeración multinivel de encabezados, no números de encabezado escritos.
• Usa campos de leyenda SEQ reales y estilos de leyenda. Para NESP, coloca las leyendas debajo de las figuras y encima de las tablas.
• Usa campos/marcadores de referencia cruzada de Word para figuras, tablas, encabezados y apéndices, no números escritos manualmente.
• Genera y actualiza el índice y las listas de figuras/tablas a partir de las estructuras del documento.
• Verifica que cada elemento visual científico tenga una leyenda, una llamada de texto significativa y una asociación correcta de fuente/datos. No trates logotipos o imágenes de portada decorativas como figuras científicas.
• Preserva los campos CWYW de EndNote y los datos incrustados. Usa herramientas de EndNote para citas en vivo nuevas/modificadas. Si no están disponibles, prepara metadatos verificados y solicitudes de inserción de citas claramente identificadas.
• Preserva los elementos preliminares requeridos, saltos de sección, encabezados/pies de página, numeración de páginas y agradecimientos. Elimina los ejemplos instructivos solo en el nuevo informe de trabajo y registra los defectos relevantes de la plantilla.

Después de editar, compara la copia de trabajo con la referencia:

python "<ruta-habilidad>/scripts/audit_docx.py" "<proyecto>/propuesto.docx" --baseline "<proyecto>/original.docx" --json "<proyecto>/audit-after.json"

Investiga los campos/marcadores cambiados o eliminados en relación con las ediciones previstas. Los recuentos por sí solos no pueden establecer la preservación. No aceptes en silencio cambios inesperados.

6. Entrega una revisión fácil

Usa cuatro categorías: formato, redacción, decisión científica y brecha de evidencia. Asigna IDs estables solo a elementos materiales. Mantén el registro de revisión, anclado por sección más un extracto de texto exacto y breve; agrega números de página después del renderizado final.

Para una revisión sustancial, proporciona:

1. Un DOCX de revisión con cambios de redacción reales marcados y comentarios anclados cuando sea seguro. Nombra una tabla de propuestas con precisión; no la llames cambios marcados.
2. Una vista de lectura limpia cuando sea útil. Prefiere la vista Sin Marcas de Word; si haces una copia de lectura separada, conserva el maestro de revisión y explica que la legibilidad no significa aceptación del autor. Nunca aceptes revisiones humanas preexistentes para simplificar el procesamiento.
3. Una lista de decisiones breve: ubicación, problema, redacción/pregunta propuesta, razón/evidencia y opciones aceptar/editar/rechazar/necesita-entrada. Agrupa las correcciones mecánicas repetitivas.
4. Un resumen de verificación que separe los elementos verificados, las entradas no resueltas y las verificaciones nativas de Word/EndNote aún necesarias.

Revisa todas las páginas renderizadas después de las ediciones de diseño. Actualiza los campos de Word y la paginación a través de Word nativo cuando esté disponible; ejecuta Actualizar Citas y Bibliografía de EndNote por separado. Verifica los anclajes de comentarios/revisiones estructuralmente porque la vista previa en PDF puede omitirlos. Una vista previa en PDF no establece la funcionalidad de cita en vivo.

Termina con las decisiones de autor más útiles, normalmente tres o menos, mientras conservas el registro completo. Mantén la corrección y el formato en movimiento. No envíes, publiques, elimines el historial de revisión, inventes roles de colaborador, ni marques la aceptación científica sin la instrucción del científico. Registra la asistencia sustancial de IA para que cualquier divulgación específica del objetivo pueda prepararse con precisión.