issue

Par tldraw · tldraw

Créez et étudiez une issue GitHub dans le dépôt tldraw à partir d'une description utilisateur. À utiliser lorsque l'utilisateur mentionne une issue, demande à en créer une, signale un bug, soumet une demande de fonctionnalité ou souhaite ajouter des recherches à une nouvelle issue.

npx skills add https://github.com/tldraw/tldraw --skill issue

Problème

Créer une GitHub issue sur tldraw/tldraw à partir d'une description utilisateur, puis l'investiguer.

Utiliser ../write-issue/SKILL.md comme référence pour les standards de titre d'issue, corps, types, labels et conventions de triage.

Workflow

  1. Rassembler le contexte :
    • Description d'issue de l'utilisateur.
    • Branche courante : git branch --show-current.
    • Issues récentes : gh issue list --repo tldraw/tldraw --limit 5 --json number,title --jq '.[] | "#\(.number) \(.title)"'.
  2. Faire une investigation rapide de la codebase :
    • Rechercher les fichiers, fonctions ou patterns pertinents mentionnés dans la description.
    • Identifier les packages, apps ou exemples probablement affectés.
    • Noter les causes évidentes, les issues liées ou les chemins de code existants.
  3. Pour les bugs visuels, identifier une cible de reproduction si possible :
    • App exemples : localhost:5420 depuis yarn dev.
    • App tldraw.com : localhost:3000 depuis yarn dev-app.
    • Site docs : localhost:3001 depuis yarn dev-docs.
    • Si des screenshots seraient utiles mais ne sont pas faisables localement, demander à l'utilisateur des screenshots et des détails spécifiques de reproduction.
  4. Écrire le titre et le corps de l'issue en utilisant ../write-issue/SKILL.md.
  5. Créer l'issue :
gh issue create --repo tldraw/tldraw --title "..." --body "..."
  1. Définir le type d'issue via GitHub GraphQL quand possible, puisque gh issue create --type n'est pas fiable d'une version à l'autre.
  2. Assigner une milestone seulement quand il y a un ajustement clair :
    • Improve developer resources pour les exemples, documentation, commentaires, starter kits, et npm create tldraw.
    • Improve automations pour GitHub Actions, review bots, CI/CD, et travaux d'automatisation.
  3. Partager l'URL de l'issue avec l'utilisateur immédiatement après sa création.
  4. Faire une investigation plus approfondie après la création :
    • Identifier les fichiers pertinents et les numéros de ligne.
    • Expliquer la cause racine des bugs.
    • Résumer le contexte architectural et le code connexe.
    • Noter les cas limites, les besoins en tests et les risques probables d'implémentation.
  5. Ajouter la recherche en tant que commentaire d'issue :
gh issue comment <issue-number> --repo tldraw/tldraw --body "..."

Règles

  • Toujours créer l'issue avant de faire une recherche approfondie afin que l'utilisateur puisse la suivre.
  • Suivre ../write-issue/SKILL.md pour tous les standards de contenu d'issue.
  • Ne pas inclure d'attribution IA dans les titres d'issue, corps, commentaires ou métadonnées.

Skills similaires