gh-wasabeef-claude-code-cookbook-plugins-fr/commands/style-ai-writing.md

## 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

```bash
/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

```bash
# 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

```markdown
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

```markdown
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

```markdown
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

```markdown
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

```bash
# 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

```bash
# 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

```bash
# 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](https://github.com/textlint-ja/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.