Plantillas de mensajes

pi puede crear prompt templates. Pídale que cree uno para su flujo de trabajo.

Las plantillas de mensajes son Markdown fragmentos que se expanden hasta formar mensajes completos. Escriba /name en el editor para invocar una plantilla, donde name es el nombre del archivo sin .md.

Pi cargas prompt templates desde:

• Global: ~/.pi/agent/prompts/*.md
• Proyecto: .pi/prompts/*.md (solo después de que se confíe en el proyecto)
• Paquetes: prompts/ directorios o pi.prompts entradas en package.json
• Configuraciones: prompts matriz con archivos o directorios
• CLI: --prompt-template <path> (repetible)

Desactive el descubrimiento con --no-prompt-templates.

---
description: Review staged git changes
---
Review the staged changes (`git diff --cached`). Focus on:
- Bugs and logic errors
- Security issues
- Error handling gaps

• El nombre del archivo se convierte en el nombre del comando. review.md se convierte en /review.
• description es opcional. Si falta, se utiliza la primera línea que no esté vacía.
• argument-hint es opcional. Cuando se configura, la sugerencia se muestra antes de la descripción en el menú desplegable de autocompletar.

Utilice argument-hint al principio para mostrar los argumentos esperados en autocompletar. Utilice <angle brackets> para los argumentos obligatorios y [square brackets] para los opcionales:

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

Esto se representa en el menú desplegable de autocompletar como:

→ 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

Escriba / seguido del nombre de la plantilla en el editor. Autocompletar muestra las plantillas disponibles con descripciones.

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

Las plantillas admiten argumentos posicionales, valores predeterminados y cortes simples:

• $1, $2,... argumentos posicionales
• $@ o $ARGUMENTS para todos los argumentos unidos
• ${1:-default} usa arg 1 cuando está presente/no vacío, de lo contrario default
• ${@:-default} o ${ARGUMENTS:-default} usa todos los argumentos cuando están presentes/no vacíos; de lo contrario, default
• ${@:N} para argumentos desde la enésima posición (indexado en 1)
• ${@:N:L} para L argumentos comenzando en N

Ejemplo:

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

Los valores predeterminados son útiles para argumentos opcionales:

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

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

• El descubrimiento de plantillas en prompts/ no es recursivo.
• Si desea plantillas en subdirectorios, agréguelas explícitamente mediante la configuración prompts o un manifiesto de paquete.