plain-zh 中文 llano

Escrito para ser leído por humanos: define los términos antes de usarlos, un solo nombre para un concepto, sin metáforas en los títulos, estructura llana.

Cada regla incluye una nota sobre el nivel de evidencia:

〔Medido〕De las 270 parejas de corpus 'lieflat-less-ai-tone' con el mismo tema y los mismos hechos, con dos rondas en la misma dirección
〔Cognitivo〕Base en ciencia cognitiva (maldición del conocimiento de Pinker, capacidad de memoria de trabajo de Cowan)
〔Ingeniería〕Prácticas de ingeniería maduras (escritura controlada ASD-STE100, guía de formato de texto chino)
〔Convención〕Convenciones de diseño de este proyecto, sin evidencia experimental, ajustables según necesidad

Dos modos

Modo de generación (cargar antes de escribir): Antes de escribir, determine la audiencia y el glosario; después de escribir, revise según P1-P7. POLICY.md es la versión resumida de 8 líneas de este modo, adecuada para incrustar en AGENTS.md / CLAUDE.md / SOUL.md de forma permanente.

Modo de revisión (operar sobre borradores): Siga el 'flujo de trabajo del modo de revisión' para generar un informe, esperar confirmación y luego reescribir.

Mecanismo de glosario del proyecto

Tanto en generación como en revisión, primero consulte las fuentes terminológicas del proyecto y luego escriba:

Prioridad de fuentes terminológicas: Instrucción actual del usuario > Glosario del proyecto (CONTEXT.md, GLOSSARY.md, tabla de correspondencia de términos) > Valores predeterminados de esta especificación. Use los términos del proyecto tal como están definidos; no reescriba términos existentes según esta especificación.
Coexistencia con flujos de trabajo de terceros: Cuando el proyecto ejecute habilidades tipo mattpocock (wayfinder, to-spec, etc.), los términos de CONTEXT.md, comandos y palabras metafóricas (wayfinder = mapa de tareas, grill = interrogación y veredicto, to-tickets = dividir en tickets de implementación, llegar a la estación = objetivo alcanzado, entrar en la niebla = posponer a la espera) se consumen como acuerdos del proyecto; las palabras de interfaz se tratan con doble vía según P3.
Gobernanza incremental: Los documentos existentes no se reescriben; la cadena de evidencia del archivo de decisiones tiene prioridad. Si el proyecto no tiene glosario y en una revisión se encuentran más de 3 términos no correspondidos, al final del informe se sugiere complementar con una tabla de correspondencia de términos; los documentos nuevos posteriores seguirán la tabla.

R1 Disciplina terminológica

P1 Definir antes de usar [Cognitivo]

Cualquier término, abreviatura, nombre de archivo, nombre de campo o nombre de herramienta debe definirse o presentarse con su correspondencia chino-inglés antes de su primera aparición. Prohibido que aparezca de la nada. Método de juicio: ¿El lector ha visto esta palabra antes? Si no, dedique una oración a explicar qué es.

Antes: "Solo ejecuta build_assets.py"
Después: "Primero empaqueta con el script de empaquetado de recursos del repositorio build_assets.py, luego ejecuta" (use aposición directa, sin paréntesis; si realmente necesita paréntesis, vea P18)

Se conserva: palabras ya definidas en secciones anteriores de este artículo; palabras de conocimiento común para la audiencia objetivo.

P2 Un solo nombre para un mismo concepto [Medido]

Un concepto debe tener un solo nombre de principio a fin. No alterne sinónimos, no invente nuevas denominaciones a medio camino.

Evidencia: La renominación sinonímica ocurre 0.83-0.86 veces por párrafo en IA, 0.49 en humanos; párrafos con más de 2 apariciones: IA 20.6-22.5%, humanos 8.4%.

Antes: En el mismo párrafo, se alternan "optimizar / mejorar / potenciar" para referirse a lo mismo
Después: En todo el texto se usa uniformemente "optimizar"

Se conserva: cambios literarios en la referencia; "también conocido como X" al introducir formalmente un término.

P3 Correspondencia en la primera aparición del término, no crear traducciones inventadas [Ingeniería]

Si existe una traducción comúnmente aceptada, úsela; si no, en la primera aparición escriba "chino (English)", y en adelante use el chino. Prohibido crear jergas inventadas o jergas estadísticas.

Antes: "Plantilla chrome cinco piezas" "Regresión de la moda" "Alejarse de la moda"
Después: "Elementos de interfaz plantilla (chrome): encabezado, cadena de meta información, etiqueta de guión" "Regresión a la media"

Se conserva: inglés fijo de la industria (API, CI/CD); palabras que el equipo acuerda mantener en original (según el glosario del proyecto).

Doble vía para palabras de interfaz: Los comandos de barra, etiquetas (Label, Status, Type), claves de configuración son la interfaz de llamada del agente; mantenga el original sin traducir. Pero cuando aparecen en el texto humano, proporcione la correspondencia en la primera aparición.

Antes: "El ticket 05, al grill, primero confirme con el usuario"
Después: "El ticket 05, al grill (interrogación y veredicto), primero confirme con el usuario"

Las líneas de metadatos de máquina (Label, Status, Blocked by, etc.) se colocan concentradas en el área de metadatos al inicio del archivo, no dispersas en el texto; los títulos de párrafo usan chino, o chino e inglés bilingües en paralelo, no títulos completos en inglés.

P4 Límite de metáforas [Convención]

Cada concepto puede tener como máximo una metáfora. Las metáforas solo aparecen en la explicación, no en títulos ni se usan repetidamente como términos. El modelo no puede juzgar la adecuación de la metáfora (consenso entre modelos 0-40%), y el filtrado posterior no es fiable, así que limite desde el origen.

Antes: Título "1. Origen y el problema que resuelve"; "Tres pilares / Pilar uno / Pilar dos" como estructura de capítulo
Después: Título "1. Fuente: qué problema resuelve"; "Tres principios / Principio uno"

Se conserva: estilo explícitamente solicitado por el usuario; metáforas confirmadas como efectivas en contextos de enseñanza (una por concepto).

R2 Calibración del lector

P5 Audiencia y lista de conocimientos previos [Cognitivo]

Antes de escribir, determine dos cosas: para quién es y qué sabe por defecto. El texto solo debe referirse a conceptos que el lector ya ha establecido. Maldición del conocimiento (curse of knowledge): lo que el autor sabe, el lector puede no saberlo, y el autor es el que más fácilmente ignora esta brecha.

P6 Límite de abreviaturas no expandidas [Cognitivo]

Como máximo 1 abreviatura no expandida por cada 100 caracteres. La memoria de trabajo solo puede manejar aproximadamente 4 elementos desconocidos a la vez; las abreviaturas continuas obligan al lector a "detenerse y dudar". Si se supera el límite, primero expanda o elimine.

P7 Dar analogías para conceptos de otros dominios [Cognitivo]

Al introducir un concepto fuera del dominio del lector, ofrezca una analogía dentro de su dominio y explique los límites de validez de la analogía. La analogía se encarga de la introducción; los límites, de evitar la distorsión.

Ejemplo: "Un registro es como una plaza de aparcamiento: cada una solo contiene un valor. Pero un registro no tiene 'completo', escribir significa sobrescribir."

R3 Señales estructurales

Ordenado por fuerza de evidencia. Acertar no es un delito, es una indicación; vuelva al contexto para decidir si aplica en cada caso.

P8 Frases de refutación [Medido 3.4x]

"No es X, sino Y" "Crees que... pero en realidad..." "Parece... pero en realidad..." "Más que... es...". En la mayoría de los casos, haga el juicio directamente.

Antes: "El modelo no está copiando, está haciendo regresión a la media"
Después: "El modelo no está copiando a nadie; lo que genera es la escritura estadísticamente más común"

Se conserva: corrección de malentendidos reales ("El error ocurre en la fase de guardado, no en la de subida").

P9 Dos puntos introductorios [Medido 3.8x]

"En una palabra:" "El núcleo es:" "La clave es:" "La razón es la siguiente:". Si la frase introductoria no aporta información, elimínela y escriba directamente la conclusión; si la primera mitad efectivamente conecta con lo anterior, simplemente cambie los dos puntos por un punto.

P10 Conexión en cadena [Medido: IA mediana 7 en cadena, humanos 1]

Al inicio de cada párrafo, retome la palabra clave del último párrafo. Sin saltos en todo el texto. Deje 1-2 saltos naturales en la cadena para que el lector participe en la deducción.

Se conserva: estilos que requieren ajuste estricto, como tutoriales y documentos legales.

P11 Tríada isomórfica [Medido: IA 29.4%, humanos 10.7%]

Tres oraciones consecutivas comparten la misma estructura sintáctica (misma estructura de inicio, mismo ritmo de cierre). Rompa una: fusione, divida o cambie el orden de las palabras; no elimine contenido.

Se conserva: retórica deliberada (discursos, manifiestos); listas; tres cosas en una narrativa progresiva.

P12 Cuatro estructuras de traducción [Medido]

Solo procese cuatro: modificadores prenominales excesivamente largos (modificadores antes del núcleo superan 15 caracteres, o dos "的" consecutivos); cláusula preposicional "当...时"; caparazones temáticos "对于...来说" "就...而言"; uso continuo de "然而，/因此，/此外，” como marcadores de inicio de párrafos adyacentes. Divida si es posible; conserve si realmente tiene función temporal o lógica.

P13 Densidad de enumeración y compresión [Medido: enumeración con comas IA 3.21 vs 1.78 por cada 1000 caracteres, prueba replicada de enumeración densa IA 1.45x, dos rondas en la misma dirección]

No más de 3 elementos enumerados en una misma cláusula; si supera, expanda en una lista o resuma y dé un enlace. Prohibido el uso de palabras colectivas numéricas — "monitoreo cuatro piezas" "comparación seis piezas" "diff tres piezas" — o escriba cada elemento uno por uno, o defínalo en la primera aparición y luego use la abreviatura. Las enumeraciones con barra se juzgan igual.

Antes: "M7 incluye página rehacer/importancia parámetros/parada temprana mala/monitoreo cuatro piezas/Retry/formulario"
Después: "M7 incluye seis elementos: rehacer página Agent, análisis de importancia de parámetros, parada temprana por malas rondas, cuatro monitoreos (curva GPU, estimación de tiempo, notificación de escritorio, doble línea loss), Retry con un clic, reforma de formulario"

Se conserva: enumeraciones propias de parámetros de línea de comandos, tablas de códigos de error, documentos tipo lista; enumeraciones con comas de tres elementos son escritura normal (lección nivel X: las enumeraciones intraoracionales son usadas por humanos con frecuencia), solo procese cuando haya más de cuatro elementos y estructura isomórfica.

P14 Rebaja de lista de palabras [Medido: diferencia no significativa]

"Empoderar, asir, cerrar el círculo, profundizar, sedimentar" y otras palabras de la lista solo generan una alerta de baja prioridad, no son motivo de cambio por sí solas. Las señales estructurales (P8-P12) tienen prioridad sobre la lista de palabras.

Nivel X (nunca cambiar): Las siguientes características no tienen poder discriminante o tienen dirección opuesta según prueba replicada; no se cambian aunque se detecten — subtítulos con números ordinales, paráfrasis tipo "esto significa", oraciones vacías que introducen listas, "primero / segundo / en resumen", oraciones interrogativas, uniformización de longitud de oración, acumulación de números precisos.

R4 Límites estilísticos

P15 Marco dramatúrgico requiere solicitud explícita [Convención]

Personalidad de aula ("material ya enviado" "comienza la clase" "museo"), comentarios teatrales, marco de entrevista, avance tipo suspense ("para —"), solo se activan cuando el usuario lo solicita explícitamente. Por defecto, narración directa.

P16 Límite de frases célebres [Convención]

Como máximo 1 resumen aforístico por artículo. Prohibido el avance de cierre tipo "una frase para llevarse".

P17 Mezcla chino-inglés [Ingeniería]

Agregue un espacio entre el chino y el inglés; use signos de puntuación de ancho completo en contexto chino; agregue un espacio entre números y unidades. Los detalles siguen la guía de formato de texto chino (sparanoid/chinese-copywriting-guidelines).

P18 Puntuación y paréntesis [Ingeniería: GB/T 15834—2011, CY/T 154—2017]

Prioridad para la notación de comentarios: aposición directa > paréntesis > guión. Los comentarios que puedan escribirse como aposición no usan paréntesis; los paréntesis se usan para notas al margen "que no necesitan leerse junto con el texto principal"; los comentarios con guión pertenecen al texto principal y necesitan leerse juntos; use con moderación en textos técnicos chinos (alta densidad de guiones es también una huella dactilar de escritura IA medida).

Aposición (primera opción): "Primero empaqueta con el script de empaquetado de recursos del repositorio build_assets.py, luego ejecuta"
Paréntesis (nota al margen): "Soporta exportación por lotes (requiere permisos de administrador)"
Guión (comentario que se lee junto, usar con moderación): Si es necesario, use guión de dos caracteres ——, sin romper, que ocupa espacio de dos caracteres, generalmente sin puntuación antes

El ancho completo o medio de los paréntesis se determina según el contenido y el entorno adyacente, con uniformidad en todo el artículo (principio de consistencia de CY/T 154):

Escenario	Forma	Ejemplo
Correspondencia "chino (English)"	Ancho completo, sin espacios alrededor	消息队列 (Message Queue)
Comentario que contiene chino	Ancho completo, sin espacios alrededor	Soporta exportación por lotes (需要管理员权限)
Solo inglés, números, referencias de versión	Ancho medio, espacio antes del paréntesis	Basado en Spring Boot (v3.2.0)
Paréntesis junto a código o nombre de archivo	Ancho medio, espacios a ambos lados	Ejecuta build.sh (首次运行会下载依赖) después de reiniciar

Divergencia conocida: las convenciones editoriales usan ancho completo para "chino (English)" (GB/T 15834, ejemplos de la guía); algunas normas de ingeniería usan ancho medio con espacio para contenido solo en inglés (Gengo). plain-zh por defecto usa ancho completo para correspondencia, ancho medio para referencias de ingeniería; si el proyecto tiene su propia convención, sígala, sin cambios en todo el artículo.

Reglas duras adicionales:

No anidar paréntesis; si es necesario anidar, use formas diferentes (exterior 〔〕 interior ())
Paréntesis intraoracionales van pegados a la palabra comentada, sin punto al final; paréntesis extraoracionales van después del punto final
Comillas: por defecto "" para simplificado, '' para anidado; comillas angulares「」『』 para tradicional o cuando el proyecto acuerde usarlas, uniforme en todo el artículo
Puntos suspensivos usen ……, no tres puntos
Elementos enumerados en inglés dentro de oraciones chinas siguen usando coma china (如：at the bus stop、at the railway station)
No más de 2 paréntesis de comentario por párrafo; las notas al margen continuas conviértanse en texto expandido

Se conserva: paréntesis de ancho medio dentro de bloques de código y líneas de comando; paréntesis de fórmulas matemáticas; paréntesis compactos en tablas; convenciones de formato existentes del proyecto.

R5 Disciplina de reescritura (aplica en modo de revisión)

P19 Cambio mínimo

Un acierto solo modifica la parte necesaria para resolver ese problema; no pula incidentalmente, no toque el texto adyacente. Cuanto más cambie, más oportunidades de introducir nuevos errores. Si no está seguro, mantenga el original.

P20 Conservación de la información

Hechos, números, calificadores, atribuciones, alcance de negaciones deben conservarse íntegros. "Posible" no se cambia a "seguro"; "planeado" no se cambia a "completado". Cada palabra de contenido añadida en la reescritura debe poder señalarse su origen en el texto original.

P21 No mover la estructura

Niveles de título, orden de capítulos, orden de párrafos, posición de listas, tablas, referencias, bloques de código se conservan tal cual. Antes de cambiar un título, revise las referencias y anclajes en todo el texto.

P22 Autoverificación después del cambio

Revise punto por punto: ¿las palabras de contenido añadidas tienen origen? ¿todos los términos están definidos en su primera aparición (P1-P3)? ¿las palabras de interfaz están correspondidas (P3)? ¿los títulos no tienen metáforas (P4)? ¿las abreviaturas no expandidas cumplen el límite (P6)? ¿las frases de refutación y los dos puntos introductorios están procesados o se ha anotado la razón para conservarlos (P8-P9)? ¿la densidad de enumeración y compresión cumple, sin palabras colectivas numéricas (P13)? ¿puntuación y paréntesis cumplen, con prioridad a aposición para comentarios (P18)? ¿el marco dramatúrgico no está activado o ha sido solicitado por el usuario (P15)?

División de juicio en tres niveles

Indicadores contables (conteo de abreviaturas, densidad de metáforas, alternancia de palabras, densidad de guiones): pueden ser scripteados; este proyecto reserva la interfaz detect
Juicio de significado de oración (si el acierto se sostiene, si el límite de conservación aplica): el modelo juzga uno por uno según los criterios cerrados de este documento; si no está seguro, marque "pendiente de verificación"
Adecuación de la metáfora: solo liste candidatos; el usuario juzga, el modelo no evalúa

Flujo de trabajo del modo de revisión

Lea todo el texto, determine el género y la audiencia, enumere las afirmaciones, datos y limitaciones que deben conservarse
Revise P1-P18 uno por uno. Para cada acierto, registre: número de regla, posición de la oración original, método de modificación, veredicto (a modificar / conservar / falso positivo / pendiente de verificación). La conservación debe dar una razón concreta, no solo "suena natural"
Genere el informe: agrupe los aciertos por R1-R4 (oración original, método de modificación, veredicto), estadísticas por categoría (terminológica / estructural / estilística). Solo pida al usuario que responda al conjunto de sugerencias con "modificar según sugerencia" o proponga ajustes; no pida decisión por cada acierto
Después de recibir confirmación, reescriba cumpliendo P19-P21. Para cada cambio, registre "original, modificado, número de regla acertada"
Después del cambio, autoverifique según P22, genere comparación antes y después (use tachado y marca de inserción para cambios), revise si los elementos a modificar se han eliminado

Verificación antes de la entrega

Cada término tiene definición o correspondencia en su primera aparición (P1, P3)
Un mismo concepto tiene un solo nombre (P2)
Los títulos no tienen metáforas (P4)
Las abreviaturas no expandidas no superan el límite (P6)
Las frases de refutación y los dos puntos introductorios están procesados o se ha anotado la razón para conservarlos (P8, P9)
El marco dramatúrgico no está activado, o ha sido solicitado explícitamente por el usuario (P15)
Las enumeraciones paralelas no superan el límite, sin palabras colectivas numéricas (P13)
Los hechos, calificadores y estructura no se han modificado (P19-P21)
Las características de nivel X no han sido modificadas erróneamente

Fuentes

lieflat-less-ai-tone: Todos los criterios de R3 y lista de nivel X (629 artículos de control + 270 pares de prueba replicada)
Fenng/Tech-Doc-Style-Chinese: Ideas de escritura controlada ASD-STE100 (P2, P3)
francoisdp/skills (anti-ai-writing): Arquitectura de dos modos y Regla 25 definir antes de usar (P1)
op7418/Humanizer-zh: Tres partes del límite de conservación y conservación de información (R5)
sparanoid/chinese-copywriting-guidelines: Normas de mezcla (P17)
GB/T 15834—2011《标点符号用法》、CY/T 154—2017《中文出版物夹用英文的编辑规范》: Formas de puntuación y principio de uniformidad de estilo (P18)
Gengo 中文风格指南: Reglas de ingeniería para determinar ancho completo/medio de paréntesis según contenido (P18)
cloudflare-docs eli5 skill: Analogía y límites de validez (P7)
opencue/cuecards ai-slop-detector: Base de carga cognitiva para abreviaturas no definidas (P6)

Licencia

MIT

Preguntar en tu IA favorita

Documentación