fluid-pr

Par microsoft · fluidframework

À utiliser lors de la création d'une pull request dans le dépôt Fluid Framework. Compose un titre et un corps de PR selon les conventions Fluid Framework, les propose à l'utilisateur, puis pousse la branche et crée la PR sur GitHub. Se déclenche sur « create a PR », « make a PR », « open a PR », « submit a PR » ou « push and create a PR ».

npx skills add https://github.com/microsoft/fluidframework --skill fluid-pr

<required> CRITIQUE Ne PAS exécuter gh pr create tant que l'utilisateur n'a pas explicitement confirmé via AskUserQuestion à l'étape 5. Ne pas sauter d'étapes.

CRITIQUE Ajoute les étapes suivantes à ta liste de tâches/todo en utilisant tes outils disponibles (TaskCreate pour Claude, TodoWrite pour Copilot) :

  1. Confirme que tu n'es PAS sur main ou une branche de release. Si c'est le cas, arrête-toi et dis à l'utilisateur : tu ne peux pas créer une PR depuis une branche protégée — il doit d'abord créer ou basculer vers une branche de fonctionnalité.
  2. Vérifie que le remote origin ne pointe pas vers microsoft/FluidFramework. Si c'est le cas, arrête-toi et dis à l'utilisateur : pousser une branche directement vers le repo principal n'est pas autorisé — il devrait plutôt pousser vers son fork.
  3. Charge la skill fluid-pr-guide MAINTENANT (via l'outil Skill) avant de composer quoi que ce soit. Elle contient les conventions de titre, le template de body et les conseils de section dont tu as besoin. Ne saute PAS cette étape et ne t'appuie pas sur ta mémoire.
  4. En utilisant la fluid-pr-guide chargée, compose le titre et le body de la PR en suivant ses conventions et son template.
  5. Affiche le titre et le body proposés en tant que texte, puis utilise immédiatement l'outil AskUserQuestion pour laisser l'utilisateur choisir quoi faire ensuite. Utilise exactement ces options :
    • « Create PR » — Pousse la branche et ouvre la pull request
    • « Create draft PR » — Pousse la branche et ouvre une draft pull request
    • « Edit » — Révise le titre ou le body avant de créer
    • « Cancel » — Ne pas créer de PR
  6. Si l'utilisateur choisit « Edit », applique ses modifications et réaffiche (retour à l'étape 5). Si « Create PR » ou « Create draft PR », pousse et crée en conséquence. Si « Cancel », arrête-toi. </required>

Pousser et créer la PR

Avant de pousser, vérifie que origin ne pointe pas vers microsoft/FluidFramework. Exécute :

git remote get-url origin

Si l'URL contient microsoft/FluidFramework, arrête-toi — pousser une branche directement vers le repo principal n'est presque certainement pas voulu. Dis à l'utilisateur qu'il devra probablement pousser vers son fork à la place. Ne procède pas.

Une fois que les vérifications des étapes 1–2 passent en silence, compose le titre et le body, affiche-les en tant que texte, puis utilise l'outil AskUserQuestion avec les quatre options comme décrit à l'étape 5. C'est le seul point où le flux fluid-pr pose une question à l'utilisateur.

# Pousse la branche (première fois)
git push -u origin <feature-branch>

# Crée la PR (option 1)
gh pr create \
  --title "<title>" \
  --body "$(cat <<'EOF'
<body>
EOF
)"

# Crée une draft PR (option 2) — ajoute le flag --draft
gh pr create \
  --draft \
  --title "<title>" \
  --body "$(cat <<'EOF'
<body>
EOF
)"

Après la création de la PR, affiche l'URL de la PR pour que l'utilisateur puisse y accéder.

Mettre à jour la description d'une PR existante

Tu n'as pas les permissions pour modifier les PR sur le repo upstream microsoft/FluidFramework via l'API. Si tu dois mettre à jour le titre ou le body d'une PR existante, écris le nouveau contenu dans un fichier temporaire et dis à l'utilisateur de le copier-coller dans GitHub :

cat <<'EOF' > "$TMPDIR/pr-body.md"
<new body content>
EOF

Puis dis à l'utilisateur : « Je ne peux pas modifier la PR directement — j'ai écrit la description mise à jour dans $TMPDIR/pr-body.md. Veuillez la copier-coller dans la PR sur GitHub. »

Skills similaires