Initial commit

commands/style-ai-writing.md

@@ -0,0 +1,186 @@
+## 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.