Moemu/skills

Especificación de redacción de documentos técnicos en chino simplificado

Integra cuatro referencias autorizadas: las normas de Ruan Yifeng sobre redacción de documentos técnicos en chino (formato y estructura), la guía de estilo de localización al chino (simplificado) de Microsoft (tono y terminología de localización), la guía de estilo de escritura de Microsoft (filosofía de escritura) y el estándar ASD-STE100 de inglés técnico simplificado (escritura controlada y documentación crítica de seguridad). Las copias completas originales de las tres primeras se encuentran en references/sources/ (las normas de Ruan Yifeng y la guía de estilo de escritura de Microsoft son submódulos de git, requieren inicialización; el borrador de la guía en chino de Microsoft se proporciona con el repositorio). La esencia de STE se resume en references/asd-ste100-core.md, y la lista de verificación en references/quick-check.md.

Tres principios fundamentales (voz de Microsoft)

Antes de escribir cada frase, recuerde: primero se ojea, luego se lee. El lector normalmente busca respuestas rápidas, no lee palabra por palabra.

1. Cálido y natural: hable como si hablara con un colega, no como si redactara un documento oficial. Use lenguaje cotidiano, evite el tono burocrático.
2. Claro y conciso: si puede usar una oración corta, no use una larga. Elimine las palabras innecesarias. Lo breve es bueno.
3. Servicial: póngase del lado del lector, dígale qué hacer a continuación, no se limite a acumular datos.

Reglas estrictas de formato

Estas reglas son casi indiscutibles; aplíquelas siempre al escribir contenido técnico en chino:

Espaciado entre caracteres chinos e ingleses

• Deje un espacio de medio ancho entre caracteres chinos y palabras en inglés: 本文介绍如何快速启动 Windows 系统.
• Entre caracteres chinos y números arábigos: se puede dejar o no espacio, pero debe ser uniforme en todo el texto (esta especificación recomienda dejar espacio).
• Deje un espacio entre números y unidades en inglés: 16 GB; no deje espacio entre números y el signo de porcentaje o unidades chinas: 6.5%, 1000 元.
• No deje espacio entre caracteres ingleses/números y signos de puntuación de ancho completo: 他的电脑是 MacBook Air。 (no MacBook Air 。)

Signos de puntuación

• En oraciones en chino, use signos de puntuación de ancho completo (，。：；？！""''（）、《》); cuando toda la oración esté en inglés, use signos de medio ancho.
• Dos puntos: En el cuerpo del documento, use de ancho completo ：; en cadenas de la interfaz de usuario (UI), use de medio ancho : (seguido de un espacio), por ejemplo, 错误: %1.
• Interrogación/Exclamación: En documentos, use de ancho completo ？！; en la UI, use de medio ancho ? !.
• Para elementos en serie, use la coma china 、, incluso si los elementos están en inglés: Google、Facebook、腾讯, y conecte el último con 和.
• Use comillas dobles de ancho completo "" para citas; dentro de comillas, si hay otra cita, use comillas simples de ancho completo ''.
• Use paréntesis de ancho completo （） para aclaraciones; no ponga espacios antes ni después. Si el contenido dentro es puramente en inglés/números, puede usar () de medio ancho.
• Cuando se añade una nota entre paréntesis, el punto final va fuera del paréntesis: 请参照第 1.3 节（见第 26 页）。
• Puntos suspensivos: En el cuerpo del documento, use los puntos suspensivos chinos ⋯⋯ (ocupan dos caracteres, seis puntos; no use ... ni 。。。); en cadenas de la UI, use los puntos suspensivos ingleses ....
• No combine puntos suspensivos con 等: use 香蕉、苹果、梨⋯⋯ o 香蕉、苹果、梨等水果, pero no ambos.
• Evite los signos de exclamación tanto como sea posible; no los use de forma consecutiva (prohibido ！！).
• La raya ocupa la posición de dos caracteres chinos: ————.
• Para rangos numéricos, use ～ o —: 132 kg～234 kg; si las unidades de los dos números son diferentes, incluya la unidad en ambos.
• En palabras compuestas y números, use el guion de medio ancho: 氧化-还原反应, 图 1-1.

Números

• Use siempre números arábigos de medio ancho, nunca de ancho completo como １００.
• A partir de miles, use el separador de miles: 1,258,000; para números de 4 dígitos, se puede usar o no, pero debe ser uniforme en todo el texto.
• Use el símbolo de moneda o el nombre chino: $1,000 o 1,000 美元.
• 增加到 indica la cantidad alcanzada; 增加了 indica el incremento; prohibido usar 降低 N 倍/减少 N 倍, en su lugar use 降低/减少百分之几.
• Los cuantificadores deben ser específicos, no use siempre 个: 两位 investigadores es mejor que 2个 investigadores.

Oraciones y párrafos

• Las oraciones deben ser lo más cortas posible: lo ideal es que una oración simple sin puntuación tenga menos de 20 caracteres; más de 40 caracteres es inaceptable. Las oraciones largas unidas por comas no deben superar los 100 caracteres o 3 líneas.
• Use oraciones simples y coordinadas; evite largas frases atributivas compuestas (no acumule muchos adjetivos antes del sustantivo).
• Use oraciones afirmativas en lugar de negativas: 请确认装置的电源已关闭, no 请确认没有接通装置的电源.
• Prohíba la doble negación: 用户必须拥有删除权限，才能删除此文件, no 没有删除权限的用户，不能删除此文件.
• Use la voz activa en lugar de la pasiva: 假如尚未安装这个软件, no 假如此软件尚未被安装.
• Un párrafo debe tratar solo un tema; coloque la oración principal al principio; los párrafos no deben exceder las 7 líneas, idealmente menos de 4; deje una línea en blanco entre párrafos; no sangre el inicio del párrafo.
• Use correctamente 的/地/得: adjetivo + 的 + sustantivo; adverbio + 地 + verbo; verbo + 得 + complemento.
• Use 的 con moderación: elimínelo si no afecta el significado; tener dos o tres 的 en una oración la hace pesada.
• Los pronombres (其/该/此/这) deben tener una referencia única y clara; omita los pronombres cuando sea posible (Microsoft: no es necesario traducir cada your/it como 你的/它).

Tono y vocabulario (adaptación china de la voz de Microsoft)

• Use 你 en lugar de 您 — coherente con todos los productos de Microsoft; es cordial pero no servil.
• Diríjase directamente al lector, indíquele una acción: 密码有误，请再试一次 es mejor que 密码不正确。请输入正确的密码。
• Evite el lenguaje excesivamente escrito: use 如果 en lugar de 倘若/假使/若要; 到 en lugar de 至 (添加到网络); 总之 en lugar de 总而言之; 只是 en lugar de 仅是.
• Evite palabras inventadas, arcaísmos y jerga de internet: prohibido 给力、山寨、亲、神马、偶、童鞋、酱紫; 粉丝、菜鸟 (solo en contexto de juegos)、量身打造 son aceptables.
• No use adjetivos absolutos como 最好、最强、唯一 (riesgo legal según la ley de publicidad + requisito de la voz de Microsoft).
• Género e inclusividad: evite 他 en contextos genéricos; use 其, omita el pronombre o use el rol (读者、用户、客户); prohibido usar términos discriminatorios como 剩女、娘炮、老外、残废; use 大龄青年、残障人士、外国人.
• En contenido relacionado con accesibilidad, 选择 es mejor que 点击 (compatible con teclado, pantalla táctil y otros métodos de entrada).
• Evite la traducción literal palabra por palabra. Primero comprenda la intención de todo el párrafo, luego reestructure como si escribiera chino de forma natural; elimine los modificadores que no afecten el significado.

Manejo de términos en inglés y chino

• La primera vez que aparezca un término en inglés, anote su traducción entre paréntesis: IOC（International Olympic Committee，国际奥林匹克委员会）, luego use directamente la abreviatura.
• Los plurales en inglés deben reducirse al singular: RAMs → RAM; las abreviaturas se escriben en mayúsculas.
• Los títulos de libros/películas en inglés se ponen entre comillas angulares chinas 《》; ... en contexto chino se cambia a ⋯⋯.
• Los nombres de productos, marcas y nombres de teclas no se traducen: Windows Server 2022 (no abreviar a Win Server 2022), Visual Studio 2022 (no VS 2022); las teclas como Ctrl、Alt、Enter、Esc、Tab se mantienen en inglés y no se añade 键 (按 Ctrl+Alt+Del).
• Las teclas de dirección se traducen como 向左键、向上键, etc.
• Formato de atajos de teclado: 翻译文本(&letra mayúscula), por ejemplo, 退出(&E); colóquelo antes de la puntuación: 搜索(&S):.
• División de franjas horarias: Madrugada 0:00–5:59, Mañana 6:00–11:59, Mediodía 12:00–12:59, Tarde 1:00–17:59, Noche 18:00–23:59.
• Mantenga la misma traducción para el mismo término en todo el texto (app → aplicación, application → aplicación; select → seleccionar, pick → escoger).
• El tiempo continuo se expresa con 正在…: Uploading… → 正在上载…; pero en títulos de capítulos Using … es 使用…, no 正在使用….

Jerarquía de títulos y estructura del documento

• Como máximo cuatro niveles de títulos; no puede aparecer un título de nivel tres directamente después de un título de nivel uno; no use números aislados (si solo hay un elemento en el mismo nivel, no cree ese nivel); los títulos de nivel inferior no deben tener el mismo nombre que los de nivel superior; evite usar títulos de nivel cuatro; en su lugar, use listas en negrita con (1) (2).
• No ponga punto final, coma ni coma china al final de un título (se permiten signos de interrogación, exclamación y comillas angulares).
• Estructura recomendada para manuales de software: Introducción [obligatorio] → Inicio rápido [opcional] → Guía de inicio (preparación del entorno/instalación/configuración) [obligatorio] → Guía avanzada [opcional] → API [opcional] → FAQ [opcional] → Apéndice (Glosario/Recetas/Solución de problemas/Registro de cambios/Comentarios) [opcional].
• Nombres de archivo: minúsculas, medio ancho, sin espacios, separados por guiones (advanced-usage.md, no advanced_usage.md; README, LICENSE son excepciones que pueden estar en mayúsculas; los caracteres chinos no se pueden usar en nombres de archivo).

Textos de interfaz de usuario (UI) y mensajes de error

• Primero diga la conclusión/problema, luego la acción; una oración un solo propósito.
• Use fragmentos de oración para mayor claridad: 步骤如下： es mejor que 请执行以下步骤：; 如图所示： es mejor que 请参阅下面的图像：.
• Utilice frases estándar para mensajes de error: Cannot find/Unable to find → 无法…; 内存不足, no traduzca literalmente 没有足够的内存; 不可用 → 无法使用….
• Los marcadores de posición %d/%s, etc., no deben modificarse; la traducción debe ser gramaticalmente natural: %d users are online → %d 位用户在线 (añadir cuantificador).
• El tono debe ser amable y cordial, no culpe al usuario ni sermonee.

Restricciones ASD-STE100 (inglés técnico controlado)

Aplica a: Documentos que requieren explícitamente cumplimiento de STE (manuales críticos de seguridad en aviación, militar, mantenimiento mecánico, etc.), textos fuente en inglés que necesitan procesamiento estable mediante traducción automática/flujo de LLM, y la redacción de todos los pasos operativos y avisos de seguridad. Consulte references/asd-ste100-core.md para el sistema de reglas completo (el estándar original tiene derechos de autor; aquí solo se mantiene la idea central).

Reglas estrictas para escribir texto en inglés conforme a STE:

• Vocabulario: solo tres categorías: palabras aprobadas en el diccionario STE (un solo significado, una sola clase gramatical), nombres técnicos (TN) y verbos técnicos (TV); las palabras fuera del diccionario solo se pueden usar si se clasifican como TN/TV aprobados por la empresa/industria.
• Verbos: solo formas simples: infinitivo, imperativo, presente/ pasado/ futuro simple, participio pasado (solo como adjetivo); prohibido el continuo, el perfecto y la acumulación de verbos auxiliares; -ing solo como nombre técnico o su modificador.
• Nombres compuestos: máximo 3 palabras; para más, escriba primero el nombre completo, luego dé la abreviatura o añada un guion.
• Ortografía americana; prohibido usar contracciones (use do not en lugar de don't); prohibido usar punto y coma; no omita sujeto, verbo ni artículo; la terminología y el fraseo deben ser siempre consistentes.

Al escribir pasos operativos y avisos de seguridad (aplicable tanto en chino como en inglés; esta es la contribución más universal de STE a esta habilidad):

• Una acción por oración; coloque la condición al principio, separada por coma, luego dé el comando.
• Use listas verticales en lugar de oraciones largas y complejas; las Notas solo proporcionan información, no instrucciones.
• Formato de tres partes para avisos de seguridad: WARNING (riesgo de lesiones personales/muerte) / CAUTION (riesgo de daños al equipo) + comando o condición + consecuencia del riesgo; elegir mal el nivel es peor que no poner aviso; cuando existan ambos riesgos, suba a WARNING.
• En texto descriptivo: cada oración ≤ 25 palabras, cada párrafo ≤ 6 oraciones, cada párrafo un tema, la información se da capa por capa.

Las reglas de vocabulario de STE no se aplican al chino, pero su espíritu se integra en el resto de esta especificación: terminología única, cuantificación de oraciones cortas (en texto de procedimientos ≤ 20 palabras → en chino, una acción por paso), no nominalizar (进行检查 → 检查), dividir oraciones sin eliminar palabras.

Resolución de conflictos (cuando múltiples especificaciones no coinciden)

1. Prioridad de escenario: Documentación técnica/tutoriales/README según la especificación de documentos (puntuación de ancho completo, puntos suspensivos ⋯⋯); cadenas de UI/mensajes de error según la especificación de software (dos puntos de medio ancho + espacio, ? ! de medio ancho, puntos suspensivos ...).
2. Prioridad de cumplimiento STE: Para textos en inglés que requieren explícitamente cumplimiento STE, prevalecen las 53 reglas de STE (vocabulario, tiempos verbales, longitud de oraciones). La voz de Microsoft y las normas generales de inglés están subordinadas.
3. La consistencia está por encima de la preferencia personal: Ya sea dejar espacio entre números y caracteres chinos, o usar el separador de miles para números de 4 dígitos, cuando la especificación permita opciones, elija una y manténgala en todo el texto.
4. La legibilidad está por encima de la correspondencia literal: Reescriba si la traducción literal resulta forzada (la voz de Microsoft autoriza explícitamente la reescritura); para conflictos específicos como puntos suspensivos vs. 等, 至, etc., siga las reglas estrictas anteriores (en escenarios de documentos, prevalece la especificación de Ruan Yifeng).
5. Para asuntos no cubiertos en esta especificación, consulte en orden: references/quick-check.md → references/asd-ste100-core.md → los textos originales correspondientes en references/sources/ (los dos submódulos requieren inicialización).

Proceso de revisión

Antes de entregar un documento técnico en chino, revíselo en el siguiente orden:

1. Formato: espacios entre chino e inglés, signos de puntuación de ancho completo/medio ancho, separador de miles en números.
2. Oraciones: dividir oraciones largas, convertir negativas en afirmativas, pasivas en activas, eliminar dobles negaciones.
3. Tono: 您 → 你, coloquializar el lenguaje escrito, eliminar 的 redundantes, verificar referencias pronominales.
4. Terminología: anotar la primera aparición, unificar traducciones, verificar que los nombres de productos y teclas no se hayan traducido.
5. Estructura: jerarquía de títulos válida, tema único por párrafo, nombres de archivo conforme a las reglas.

Consulte la tabla de correspondencias de errores y aciertos en references/quick-check.md.