/style-ai-writing

Vérification Écriture IA

Détecte les motifs mécaniques dans les textes générés par IA et fournit des suggestions pour améliorer vers un français plus naturel.

Utilisation

/ai-writing-check [options]

Options

• Aucune : Analyser le fichier actuel ou le texte sélectionné
• --file <path> : Analyser un fichier spécifique
• --dir <path> : Analyser en lot les fichiers dans un répertoire
• --severity <level> : Niveau de détection (all/high/medium)
• --fix : Corriger automatiquement les motifs détectés

Exemples de base

# Vérifier le style d'écriture IA dans un fichier
cat README.md
/ai-writing-check
"Check this document for AI writing style and suggest improvements"

# Analyser un fichier spécifique
/ai-writing-check --file docs/guide.md
"Detect AI-like expressions and suggest corrections to natural expressions"

# Scanner tout le projet
/ai-writing-check --dir . --severity high
"Report only critical AI writing issues in the project"

Motifs détectés

1. Motifs de format de liste mécanique

Exemples détectés :

- **Important** : Ceci est un élément important
- Élément terminé (avec emoji coche)
- Sujet populaire (avec emoji feu)
- Prêt à commencer (avec emoji fusée)

Exemples améliorés :

- Élément important : Ceci est un élément important
- Élément terminé
- Sujet notable
- Prêt à commencer

2. Expressions exagérées/promotionnelles

Exemples détectés :
Une technologie révolutionnaire qui va changer l'industrie.
Cela résout complètement le problème.
Fonctionne comme par magie.

Exemples améliorés :
Une technologie efficace qui apporte des changements dans l'industrie.
Résout de nombreux problèmes.
Fonctionne de manière fluide.

3. Motifs d'emphase mécanique

Exemples détectés :
**Idée** : Nouvelle proposition (avec emoji ampoule)
**Attention** : Avertissement important (avec emoji attention)

Exemples améliorés :
Idée : Nouvelle proposition
Note : Avertissement important

4. Rédaction technique redondante

Exemples détectés :
Premièrement, nous allons effectuer la configuration.
Vous pouvez utiliser cet outil.
Les performances sont grandement améliorées.

Exemples améliorés :
Premièrement, effectuez la configuration.
Vous pouvez utiliser cet outil.
Les performances s'améliorent de 30%.

Collaboration avec Claude

# Analyser tout le document pour le style d'écriture IA
cat article.md
/ai-writing-check
"Analyze and suggest improvements from these perspectives:
1. Detection of mechanical expressions
2. Suggestions for correction to natural French
3. Priority-based improvement list"

# Focus sur des motifs spécifiques
/ai-writing-check --file blog.md
"Pay special attention to exaggerated and redundant expressions and suggest improvements"

# Vérification en lot de plusieurs fichiers
find . -name "*.md" -type f
/ai-writing-check --dir docs/
"Analyze AI writing style throughout the documentation and create a summary"

Exemples détaillés

# Comparer avant et après amélioration
/ai-writing-check --file draft.md
"Detect AI-like expressions and present them in the following format:
- Problem areas (with line numbers)
- Type of problem and reason
- Specific improvement suggestions
- Effect of improvement"

# Mode de correction automatique
/ai-writing-check --file report.md --fix
"Automatically fix detected patterns and report results"

# Rapport de style d'écriture IA du projet
/ai-writing-check --dir . --severity all
"Analyze AI writing style throughout the project and provide:
1. Statistical information (detection count by pattern)
2. Top 5 most problematic files
3. Improvement priority matrix
4. Step-by-step improvement plan"

Exemples d'utilisation avancée

# Appliquer des règles personnalisées
/ai-writing-check --file spec.md
"Check technical specifications with these additional criteria:
- Ambiguous expressions (appropriate, as needed)
- Lack of specificity (fast → specific numbers)
- Inconsistent terminology usage"

# Vérification pour intégration CI/CD
/ai-writing-check --dir docs/ --severity high
"Output results in GitHub Actions executable format:
- Number of errors and filenames
- Line numbers requiring correction
- Exit code configuration"

# Vérification de conformité au guide de style
/ai-writing-check --file manual.md
"Additional checks based on company style guide:
- Honorific usage (unification of vous form)
- Appropriate use of technical terms
- Consideration for readers"

Notes

• La détermination du style d'écriture IA varie selon le contexte, traitez les suggestions comme référence
• Ajustez les critères selon le type de document (documents techniques, blogs, manuels, etc.)
• Vous n'avez pas besoin d'accepter toutes les suggestions ; sélectionnez celles appropriées
• L'option --fix corrige automatiquement les motifs détectés

Comportement d'exécution de commande

Quand vous exécutez la commande /ai-writing-check, Claude effectue les processus suivants :

1. Détection de motifs : Détecte les motifs de type IA depuis les fichiers spécifiés ou le texte
2. Suggestions de correction spécifiques : Présente les suggestions de correction avec numéros de ligne pour chaque problème
3. Mode --fix : Corrige automatiquement les motifs détectés et affiche un résumé des résultats
4. Génération de rapport : Fournit le nombre de détections, la priorité d'amélioration, et la comparaison avant/après correction

Claude lit le contenu réel des fichiers et effectue l'analyse basée sur les règles de textlint-rule-preset-ai-writing.

Référence

Cette commande est créée en référence au jeu de règles textlint-rule-preset-ai-writing. C'est un preset de règles textlint pour détecter les motifs mécaniques dans les textes générés par IA et promouvoir des expressions plus naturelles.