Ceci constitue la couche fondamentale d'un ensemble de compétences en rédaction technique, chargée lors de la rédaction de textes de plus d'un paragraphe dans le dépôt, tels que les spécifications, les documents de conception, les fichiers README et les rapports. Avant de commencer, il faut lire les documents similaires du même répertoire et définir le type de document, le public cible, l'objectif et le périmètre non couvert. Les règles strictes incluent : ne pas considérer comme des faits des informations dont la source ne peut être vérifiée, ne pas inclure de journal des modifications dans les documents, et ne jamais modifier les décisions acceptées, mais seulement les ajouter. Le même dépôt contient également des compétences spécialisées pour les documents de conception, les journaux des modifications, les manuels d'exploitation, les analyses post-incident, la référence API et la relecture.
Pourquoi c'est important Déterminez le type de document avant de commencer : pour les documents normatifs, ne modifiez pas le document si le code viole les règles, et ne réécrivez pas l'historique, afin d'éviter que l'agent ne modifie les conventions à respecter sous prétexte de « synchroniser le code ».
Audit de sécurité : Non audité
- Pas encore scanné
Raisons
- skills.sh 24 heures d'installation 417 (représente uniquement l'attention) ; Licence MIT
- SKILL.md lu depuis le dépôt : règles de rédaction pures, n'exécute pas de commandes, ne se connecte pas à Internet
Utilisation
- Une fois installé, demandez à l'agent de rédiger ou de modifier les documents du dépôt ; chargez la compétence spécialisée correspondante lors de la rédaction de types spécifiques, et utilisez reviewing-technical-prose pour une relecture avant la livraison
Risques
- Pas encore soumis à un audit automatique sur ordinateur, le site n'affiche pas les commandes d'installation
- Les règles sont en anglais, et certaines listes de termes interdits ne s'appliquent qu'aux documents en anglais