posting-bitwarden-review-comments

Utilisez cette skill lors de la publication de commentaires inline sur les pull requests GitHub. Appliquez-la pour formater les commentaires conformément aux standards d'ingénierie Bitwarden, avec des emojis de sévérité, des explications claires et des suggestions concrètes. À utiliser après la classification des findings et lorsqu'ils sont prêts à être publiés. NE PAS UTILISER pour la publication de commentaires récapitulatifs.

npx skills add https://github.com/bitwarden/ai-plugins --skill posting-bitwarden-review-comments

Poster des commentaires d'examen Bitwarden

Protocole de commentaire GitHub

  1. OBLIGATOIRE Analyser tous les changements avant de poster quoi que ce soit
  2. OBLIGATOIRE Utiliser les commentaires inline pour les découvertes spécifiques au code
  3. OBLIGATOIRE Utiliser le format de découverte Bitwarden
  4. INTERDIT : NE PAS ajouter de sections "Strengths", "Highlights", ou observations positives.
  5. INTERDIT NE PAS poster de commentaires inline uniquement élogieux
  6. INTERDIT : NE PAS poster les métadonnées de PR (titre, description, plan de test) en commentaires inline. Ceux-ci vont dans le résumé seulement.

Format de découverte

CRITIQUE : Ne jamais utiliser # suivi de chiffres - GitHub créera automatiquement un lien vers des issues/PR non pertinentes.

  1. Écrire "#1" crée un lien cliquable vers l'issue/PR #1 (pas votre découverte)
  2. "Issue" est aussi une terminologie incorrecte (utiliser "Finding")
  3. Utiliser "Finding" + espace + numéro (pas de symbole #); viser moins de 30 mots dans la phrase

FORMAT CORRECT :

  • Finding 1: Memory leak detected
  • Finding 2: Missing error handling

FAUX (À NE PAS UTILISER) :

  • ❌ Issue #1 (mauvais terme + autolink)
  • ❌ #1 (autolink seulement)
  • ❌ Issue 1 (mauvais terme seulement)

Commentaires inline

Chaque commentaire inline DOIT :

  1. Référencer la/les ligne(s) spécifique(s)
  2. Exposer le problème - qu'est-ce qui casse ou quel est le risque?
  3. Fournir une correction exploitable (pour ❌ et ⚠️)
  4. Être bref mais clair
  5. Utiliser des sections repliables pour les commentaires de plus de 5 lignes
  6. Inclure à la fois les balises <details> d'ouverture ET de fermeture </details>

Règle de visibilité : Seulement la sévérité + description d'une ligne visible; tout le reste à l'intérieur des balises <details>.

Modèle pour les longs commentaires

[emoji] **[SEVERITY]**: [One-line issue description]

<details>
<summary>Details and fix</summary>

[Code example or specific fix]

[Rationale explaining why]

Reference: [docs link if applicable]
</details>

Sortie du résumé

Invoquer Skill(posting-review-summary) pour tout formatage de résumé et affichage.

Skills similaires