Initial commit

commands/style-ai-writing.md

@@ -0,0 +1,186 @@
+## 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
+
+```bash
+/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
+
+```bash
+# 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
+
+```markdown
+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
+
+```markdown
+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
+
+```markdown
+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
+
+```markdown
+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
+
+```bash
+# 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
+
+```bash
+# 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
+
+```bash
+# 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](https://github.com/textlint-ja/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.