Configuration, personnalisation, paramètres de plateforme et références API pour Pi.

Modèles d'invite

pi peut créer prompt templates. Demandez-lui d'en créer un pour votre flux de travail.

Les modèles d'invites sont des extraits de Markdown qui se transforment en invites complètes. Tapez /name dans l'éditeur pour appeler un modèle, où name est le nom du fichier sans .md.

Emplacements

Pi charge prompt templates depuis:

  • Mondial: ~/.pi/agent/prompts/*.md
  • Projet: .pi/prompts/*.md (uniquement une fois le projet approuvé)
  • Forfaits: prompts/ répertoires ou pi.prompts entrées dans package.json
  • Paramètres: prompts tableau avec des fichiers ou des répertoires
  • CLI: --prompt-template <path> (répétable)

Désactivez la découverte avec --no-prompt-templates.

Format

---
description: Review staged git changes
---
Review the staged changes (`git diff --cached`). Focus on:
- Bugs and logic errors
- Security issues
- Error handling gaps
  • Le nom du fichier devient le nom de la commande. review.md devient /review.
  • description est facultatif. En cas d'absence, la première ligne non vide est utilisée.
  • argument-hint est facultatif. Lorsqu'il est défini, l'indice s'affiche avant la description dans la liste déroulante de saisie semi-automatique.

Conseils d'argumentation

Utilisez argument-hint en frontmatter pour afficher les arguments attendus en saisie semi-automatique. Utilisez <angle brackets> pour les arguments obligatoires et [square brackets] pour les arguments facultatifs:

---
description: Review PRs from URLs with structured issue and code analysis
argument-hint: "<PR-URL>"
---

Cela s'affiche dans la liste déroulante de saisie semi-automatique comme:

→ pr   <PR-URL>       — Review PRs from URLs with structured issue and code analysis
  is   <issue>        — Analyze GitHub issues (bugs or feature requests)
  wr   [instructions] — Finish the current task end-to-end
  cl   — Audit changelog entries before release

Usage

Tapez / suivi du nom du modèle dans l'éditeur. La saisie semi-automatique affiche les modèles disponibles avec des descriptions.

/review                           # Expands review.md
/component Button                 # Expands with argument
/component Button "click handler" # Multiple arguments

Arguments

Les modèles prennent en charge les arguments de position, les valeurs par défaut et le découpage simple:

  • $1, $2,... arguments de position
  • $@ ou $ARGUMENTS pour tous les arguments joints
  • ${1:-default} utilise arg 1 lorsqu'il est présent/non vide, sinon default
  • ${@:-default} ou ${ARGUMENTS:-default} utilise tous les arguments lorsqu'ils sont présents/non vides, sinon default
  • ${@:N} pour les arguments de la Nième position (indexé 1)
  • ${@:N:L} pour L arguments commençant à N

Exemple:

---
description: Create a component
---
Create a React component named $1 with features: $@

Les valeurs par défaut sont utiles pour les arguments facultatifs:

Summarize the current state in ${1:-7} bullet points.

Utilisation: /component Button "onClick handler" "disabled support"

Règles de chargement

  • La découverte de modèles dans prompts/ n'est pas récursive.
  • Si vous souhaitez des modèles dans des sous-répertoires, ajoutez-les explicitement via les paramètres prompts ou un manifeste de package.