/style-ai-writing

Verificación de Escritura AI

Detecta patrones mecánicos en texto generado por IA y proporciona sugerencias para mejorar a español más natural.

Uso

/ai-writing-check [opciones]

Opciones

• Ninguna: Analizar archivo actual o texto seleccionado
• --file <ruta>: Analizar archivo específico
• --dir <ruta>: Analizar archivos en lote en directorio
• --severity <nivel>: Nivel de detección (all/high/medium)
• --fix: Corregir automáticamente patrones detectados

Ejemplos Básicos

# Verificar estilo de escritura AI en archivo
cat README.md
/ai-writing-check
"Verificar este documento por estilo de escritura AI y sugerir mejoras"

# Analizar archivo específico
/ai-writing-check --file docs/guide.md
"Detectar expresiones similares a AI y sugerir correcciones a expresiones naturales"

# Escanear todo el proyecto
/ai-writing-check --dir . --severity high
"Reportar solo problemas críticos de escritura AI en el proyecto"

Patrones Detectados

1. Patrones de Formato de Lista Mecánica

Ejemplos detectados:

- **Importante**: Este es un elemento importante
- Elemento completado (con emoji de marca de verificación)
- Tema candente (con emoji de fuego)
- Listo para comenzar (con emoji de cohete)

Ejemplos mejorados:

- Elemento importante: Este es un elemento importante
- Elemento completado
- Tema notable
- Listo para comenzar

2. Expresiones Exageradas/Promocionales

Ejemplos detectados:
La tecnología revolucionaria cambiará la industria.
Esto resuelve completamente el problema.
Funciona como magia.

Ejemplos mejorados:
La tecnología efectiva trae cambios a la industria.
Resuelve muchos problemas.
Funciona sin problemas.

3. Patrones de Énfasis Mecánico

Ejemplos detectados:
**Idea**: Nueva propuesta (con emoji de bombilla)
**Precaución**: Advertencia importante (con emoji de advertencia)

Ejemplos mejorados:
Idea: Nueva propuesta
Nota: Advertencia importante

4. Escritura Técnica Redundante

Ejemplos detectados:
Primero, realizaremos la configuración.
Puedes usar esta herramienta.
El rendimiento mejora enormemente.

Ejemplos mejorados:
Primero, realiza la configuración.
Puedes usar esta herramienta.
El rendimiento mejora un 30%.

Colaboración con Claude

# Analizar todo el documento por estilo de escritura AI
cat article.md
/ai-writing-check
"Analizar y sugerir mejoras desde estas perspectivas:
1. Detección de expresiones mecánicas
2. Sugerencias para corrección a español natural
3. Lista de mejoras basada en prioridades"

# Enfocarse en patrones específicos
/ai-writing-check --file blog.md
"Prestar especial atención a expresiones exageradas y redundantes y sugerir mejoras"

# Verificación en lote de múltiples archivos
find . -name "*.md" -type f
/ai-writing-check --dir docs/
"Analizar estilo de escritura AI en toda la documentación y crear un resumen"

Ejemplos Detallados

# Comparar antes y después de la mejora
/ai-writing-check --file draft.md
"Detectar expresiones similares a AI y presentarlas en el siguiente formato:
- Áreas problemáticas (con números de línea)
- Tipo de problema y razón
- Sugerencias específicas de mejora
- Efecto de la mejora"

# Modo de corrección automática
/ai-writing-check --file report.md --fix
"Corregir automáticamente patrones detectados y reportar resultados"

# Reporte de estilo de escritura AI del proyecto
/ai-writing-check --dir . --severity all
"Analizar estilo de escritura AI en todo el proyecto y proporcionar:
1. Información estadística (conteo de detección por patrón)
2. Top 5 archivos más problemáticos
3. Matriz de prioridades de mejora
4. Plan de mejora paso a paso"

Ejemplos de Uso Avanzado

# Aplicar reglas personalizadas
/ai-writing-check --file spec.md
"Verificar especificaciones técnicas con estos criterios adicionales:
- Expresiones ambiguas (apropiado, según sea necesario)
- Falta de especificidad (rápido → números específicos)
- Uso inconsistente de terminología"

# Verificar para integración CI/CD
/ai-writing-check --dir docs/ --severity high
"Generar resultados en formato ejecutable de GitHub Actions:
- Número de errores y nombres de archivos
- Números de línea que requieren corrección
- Configuración de código de salida"

# Verificación de cumplimiento de guía de estilo
/ai-writing-check --file manual.md
"Verificaciones adicionales basadas en guía de estilo de la empresa:
- Uso de tratamiento formal (unificación de forma formal)
- Uso apropiado de términos técnicos
- Consideración por los lectores"

Notas

• La determinación de estilo de escritura AI varía según el contexto, así que trata las sugerencias como referencia
• Ajustar criterios según el tipo de documento (documentos técnicos, blogs, manuales, etc.)
• No necesitas aceptar todas las sugerencias; selecciona las apropiadas
• La opción --fix corrige automáticamente patrones detectados

Comportamiento de Ejecución del Comando

Cuando ejecutas el comando /ai-writing-check, Claude realiza los siguientes procesos:

1. Detección de Patrones: Detecta patrones similares a AI de archivos o texto especificados
2. Sugerencias de Corrección Específicas: Presenta sugerencias de corrección con números de línea para cada problema
3. Modo --fix: Corrige automáticamente patrones detectados y muestra un resumen de resultados
4. Generación de Reporte: Proporciona conteo de detección, prioridad de mejora y comparación antes/después de corrección

Claude lee el contenido real del archivo y realiza análisis basado en las reglas de textlint-rule-preset-ai-writing.

Referencia

Este comando está creado con referencia al conjunto de reglas textlint-rule-preset-ai-writing. Es un preset de reglas textlint para detectar patrones mecánicos en texto generado por IA y promover expresiones más naturales.