
de tech-doc-style-chinese356
Directives pour rédiger une documentation technique et des textes de produit en chinois clairs et faciles à parcourir, tout en préservant les littéraux lisibles par machine et les termes spécifiques au projet.
Cette compétence fournit un ensemble complet de directives et de règles éditoriales pour rédiger et modifier la documentation technique chinoise, les pages produit, les textes d'interface, le contenu des fichiers README et les documents Markdown. Elle impose un ton retenu et précis, une structure optimisée pour la lecture rapide et une typographie cohérente (par exemple, les guillemets d'angle droits 「」, l'espacement entre le texte chinois et latin lorsque cela est approprié), tout en préservant explicitement les littéraux de code, les clés JSON, les URL et tout autre contenu lisible par machine. Les instructions incluent des règles de ton, les mots à effet marketing interdits, des règles typographiques et une liste de contrôle pour la relecture finale.
Utilisez cette compétence lors de la génération ou de la révision de contenu technique en chinois : pages d'accueil de documentation, docs API, descriptions de paramètres, notes de mise à jour, pages de fonctionnalités produit, textes d'interface utilisateur (boutons, libellés, messages) et pages techniques proches du marketing. Évitez de l'utiliser pour réécrire des littéraux de code, des clés JSON, des URL, des chemins d'API ou des noms de champs de base de données.
Idéal pour les agents de rédaction et d'édition gérant du contenu multilingue et Markdown (agents intégrés à des éditeurs compatibles Markdown ou des assistants de type Claude/Copilot). Fonctionne bien avec les agents capables de réécrire et de vérifier la documentation tout en préservant les blocs de code et les chaînes littérales.
Compétence de guide de style de documentation technique chinoise avec un script de linting bien structuré. Le SKILL.md fournit des règles complètes pour la ponctuation, la terminologie, la casse et les corrections courantes de fautes de frappe en chinois. Le script de lint est bien écrit avec des modèles regex et une gestion d'erreurs appropriés, mais a terminé avec le code 1 (aucun fichier .md trouvé dans le répertoire temporaire isolé, ce qui est le comportement attendu pour un linter). Aucune préoccupation de sécurité — analyse purement statique sans appels réseau ni opérations destructrices.
Compétence propre et bien documentée. Le script de lint est un outil d'analyse statique solide pour les documents techniques chinois — vérifie les guillemets interdits, les termes d'adresse (你/您/同学), les règles de casse, les règles d'abréviation, les conventions de termes IA et les fautes de frappe courantes. L'architecture est correcte mais les scripts sont à la racine plutôt qu'organisés dans un répertoire scripts/ au sein du dépôt lui-même. La compétence fait référence à un fichier references/Project-Overrides.md qui n'est pas inclus, ce qui est acceptable car il est optionnel. Utile pour les équipes de documentation chinoises mais public de niche.