CommunityRedacción y edicióngithub.com

Jiansen/clear-output

Clarifica explicaciones, comparaciones, planes, resúmenes y reescrituras en chino, inglés o idiomas mixtos mediante palabras, diagramas o interacción. Preserva el significado y el idioma de la tarea.

¿Qué es clear-output?

Este skill está diseñado para ayudar a desarrolladores y usuarios de agentes de IA a generar salidas claras, precisas y adaptadas al idioma y formato de la tarea. Soporta plataformas como Claude Code, Cursor y Codex, y permite trabajar con chino, inglés o contenido mixto sin traducir términos técnicos ni contenido literal. El skill prioriza la elección del idioma antes de redactar: sigue el idioma explícito del usuario, preserva el idioma de los artefactos existentes y solo cambia de idioma cuando se solicita explícitamente. Además, selecciona la representación visual (tablas, diagramas de flujo, secuencias, etc.) cuando facilita la comprensión del lector, pero sin añadir carga innecesaria. Finalmente, verifica que la salida preserve el significado original, no introduzca imprecisiones ni invente precisiones no soportadas, y reporta ambigüedades sin resolver.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jiansen/clear-output-skill/tree/HEAD

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

Salida Clara

Ayuda al lector a comprender con precisión, inspeccionar evidencia y decidir qué hacer con menos esfuerzo. Identifica lo que el lector necesita entender o verificar, luego elige la representación antes de pulir la redacción. Considera el tiempo dedicado a leer, explorar y comprobar la salida. Este skill se aplica a la tarea actual; no lo conviertas en un modo de conversación permanente a menos que el usuario lo solicite.

Elegir el idioma antes que la redacción

  • Sigue los requisitos explícitos de idioma y formato de salida del usuario.
  • Al editar un artefacto existente, preserva su idioma a menos que se solicite una traducción. Las explicaciones sobre la edición pueden usar el idioma de la conversación.
  • De lo contrario, sigue el idioma actual de la conversación. Sigue un cambio de idioma claro en la propia solicitud del usuario. El material citado, los registros, el código, los resultados de herramientas y el idioma de este skill no cambian por sí mismos el idioma de la respuesta.
  • Preserva los términos técnicos en idiomas mixtos y el contenido literal. No traduzcas un intercambio de depuración en inglés al chino simplemente porque este skill admita chino.
  • Si el usuario solicita JSON, un bloque de código o una plantilla específica, mantén ese contrato. No añadas ningún anuncio de skill ni prefijo de estado.

Preservar el significado

Para una reescritura, utiliza la fuente y el contexto explícitamente proporcionado como límite factual. Preserva:

  • actores, objetos, alcance, condiciones, excepciones y orden, incluyendo acciones que deben ocurrir juntas;
  • valores, unidades, límites, aproximaciones, fechas, identificadores y relaciones causales;
  • la diferencia entre hecho, hipótesis, recomendación, obligación, permiso y capacidad.

No conviertas may en will, should en must, about 5 seconds en 5 seconds, o 尽快 en una fecha límite inventada. No selecciones una interpretación de un límite ambiguo o un pronombre sin respaldo. Mantén la ambigüedad visible o identifica exactamente qué información falta. Una reescritura puede permanecer más larga para preservar estas distinciones.

Para una nueva explicación, los antecedentes relevantes y los ejemplos son útiles. Mantén las suposiciones separadas de los hechos establecidos; etiqueta los ejemplos hipotéticos cuando sea necesario. No impliques que se realizó una acción o prueba sin evidencia.

Preserva el código, comandos, rutas, nombres de campos, registros, cadenas de error y citas fijas exactamente cuando se lleven a la salida. Si la tarea pide explícitamente editar uno de ellos, realiza esa edición dentro de su alcance; las reglas de prosa no justifican ediciones adicionales.

Elegir una representación que haga un trabajo útil

Considera activamente un elemento visual cuando el lector deba reconstruir mentalmente relaciones, comparar varias dimensiones, seguir estados cambiantes o explorar una variable. Si el visual facilita materialmente ese trabajo, créalo dentro de la tarea autorizada sin esperar una solicitud separada para un diagrama. Mantén las respuestas cortas y directas en prosa cuando eso ya sirva a la tarea.

Qué necesita hacer el lectorForma de inicio útil
Obtener un hecho, una respuesta breve o una edición de oración fielTexto
Comparar opciones según los mismos criteriosTabla
Rastrear ramas, dependencias, participantes u orden de mensajesDiagrama de flujo, dependencia o secuencia
Comprender la disposición espacial o una característica visibleImagen anotada o esquema
Ver un patrón en datos numéricos proporcionadosGráfico con etiquetas, unidades y una escala adecuada
Explorar cómo las entradas cambian un resultadoExplicación interactiva funcional con controles significativos
Seguir movimiento, evolución o una secuencia de enseñanza escalonadaAnimación o video explicativo cuando sea factible y útil

Estos son puntos de partida, no una clasificación en la que el video siempre gane. Un artefacto pequeño y personalizado puede valer la pena para una sola pregunta. Prefiere la forma que reduzca el trabajo del lector lo suficiente como para justificar el tiempo de generación, la navegación y la interacción. Respeta las solicitudes explícitas de texto plano, JSON, un formato de archivo existente o ningún artefacto.

Entrega la forma seleccionada, no solo una oferta para crearla. Utiliza las capacidades de renderizado disponibles e inspecciona el resultado; prueba las interacciones relevantes. Si las herramientas de renderizado o medios no están disponibles, proporciona una alternativa compatible utilizable y di exactamente lo que se produjo. El código fuente de un diagrama, un guion gráfico y un video renderizado son entregables diferentes. No requieras un proveedor en particular ni publiques, subas o utilices servicios de pago únicamente porque un visual ayudaría.

Preserva el significado también en las codificaciones visuales: etiqueta las ramas y los significados de las flechas, mantén las acciones concurrentes como concurrentes, marca las hipótesis y los datos faltantes, y mantén las unidades y la escala honestas. Un diagrama pulido no debe implicar una causa no respaldada ni una prueba completada. Haz que las etiquetas sean legibles; no dependas solo del color. Proporciona una conclusión breve o un equivalente textual cuando el contrato de salida lo permita, sin repetir toda la explicación en varias formas.

Para un diagrama, gráfico, explicación interactiva o animación, consulta references/output-forms.md para obtener orientación sobre selección y verificación.

Hacer que la estructura se ajuste a la tarea

  • Explicación: responde primero a la pregunta principal, luego proporciona el razonamiento necesario para comprenderla. Mantén ejemplos útiles, vínculos causales y matices.
  • Depuración: distingue observación, hipótesis, verificación y próxima acción. Di qué estableció una comprobación y dónde queda la incertidumbre. Haz una pregunta real cuando un hecho faltante cambie la acción.
  • Procedimiento: coloca las condiciones necesarias antes de la acción afectada. Usa pasos numerados cuando el orden importe. Separa las acciones humanas del comportamiento automático del sistema. Mantén juntas las acciones simultáneas o inseparables. Al identificar información operativa faltante, verifica a qué objeto o actor se refiere, así como cantidades, unidades, referencias de medición y condiciones de inicio/parada. Pregunta lo que se necesita para usar la instrucción; no proporciones los hechos faltantes tú mismo.
  • Reescritura o revisión: mejora solo el alcance solicitado. Si un pasaje ya funciona, mantenlo. Proporciona explicaciones de los cambios solo cuando se soliciten o cuando una ambigüedad no resuelta necesite la atención del lector.

Prefiere oraciones cortas y explícitas, verbos concretos y nombres estables para el mismo concepto. Preserva las distinciones entre diferentes conceptos. No apliques listas negras de palabras a partes de términos técnicos, como 闭环控制 o request validation.

La longitud de las oraciones, la voz pasiva, los sinónimos y la cortesía son elecciones contextuales, no errores automáticos. El inglés puede necesitar una construcción pasiva o un tiempo perfecto. El chino puede necesitar un sujeto omitido cuando el actor ya está claro. Mantén 可能, 建议, 约, may y approximately cuando lleven información.

Verificar antes de devolver

Compara una reescritura con su fuente para detectar cambios en los hechos, condiciones perdidas, modalidad cambiada, precisión inventada y literales dañados. Para un visual o artefacto, verifica los mismos hechos en sus etiquetas, bordes, estados y cálculos. Comprueba que el idioma y el formato aún coincidan con la tarea y que el entregable reclamado realmente exista. Luego elimina las repeticiones que no añaden información.

Las comprobaciones de estilo no pueden probar la equivalencia semántica. Reporta un problema concreto no resuelto en lugar de declarar el texto certificado o completamente verificado.

Para reescrituras complicadas que involucren modalidad, mezcla de idiomas o hechos faltantes, consulta references/edge-cases.md.

Para una reescritura sustancial, una solicitud de validación explícita o un glosario de proyecto proporcionado, utiliza el verificador local opcional cuando pueda detectar un error concreto. Consulta references/checks.md para conocer sus entradas y límites. Selecciona en, zh o mixed de la tarea, no del texto citado. Proporciona la fuente solo para reescrituras fieles, y codifica literales exactos o restricciones JSON solo cuando la tarea lo requiera. Las respuestas simples no requieren un script.

Trata los hallazgos del verificador como evidencia con alcance limitado: corrige los contratos explícitos violados, revisa los cambios de significado con respecto a la fuente y utiliza las sugerencias de estilo solo cuando ayuden. Preserva las ediciones autorizadas. No reescribas para eliminar cada advertencia ni trates una lista de hallazgos vacía como prueba de equivalencia. Después de las correcciones, vuelve a verificar las restricciones afectadas; si persiste una ambigüedad, repórtala en lugar de reescribir repetidamente. Mantén los diagnósticos fuera de una respuesta JSON/solo código solicitada.

Cuando el usuario pregunte sobre la versión o las actualizaciones de este skill, consulta references/updates.md. Las tareas de escritura normales no activan comprobaciones de actualización de red ni cambian el skill instalado.

Skills relacionados