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
- 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)"'.
- 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.
- Pour les bugs visuels, identifier une cible de reproduction si possible :
- App exemples :
localhost:5420depuisyarn dev. - App tldraw.com :
localhost:3000depuisyarn dev-app. - Site docs :
localhost:3001depuisyarn 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.
- App exemples :
- Écrire le titre et le corps de l'issue en utilisant
../write-issue/SKILL.md. - Créer l'issue :
gh issue create --repo tldraw/tldraw --title "..." --body "..."
- Définir le type d'issue via GitHub GraphQL quand possible, puisque
gh issue create --typen'est pas fiable d'une version à l'autre. - Assigner une milestone seulement quand il y a un ajustement clair :
Improve developer resourcespour les exemples, documentation, commentaires, starter kits, etnpm create tldraw.Improve automationspour GitHub Actions, review bots, CI/CD, et travaux d'automatisation.
- Partager l'URL de l'issue avec l'utilisateur immédiatement après sa création.
- 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.
- 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.mdpour tous les standards de contenu d'issue. - Ne pas inclure d'attribution IA dans les titres d'issue, corps, commentaires ou métadonnées.