Modelos de prompt

pi pode criar prompt templates. Peça para criar um para o seu fluxo de trabalho.

Os modelos de prompt são Markdown trechos que se expandem em prompts completos. Digite /name no editor para invocar um modelo, onde name é o nome do arquivo sem .md.

Pi carrega prompt templates de:

• Globais: ~/.pi/agent/prompts/*.md
• Projeto: .pi/prompts/*.md (somente depois que o projeto for confiável)
• Pacotes: diretórios prompts/ ou entradas pi.prompts em package.json
• Configurações: prompts array com arquivos ou diretórios
• CLI: --prompt-template <path> (repetível)

Desative a descoberta com --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

• O nome do arquivo se torna o nome do comando. review.md torna-se /review.
• description é opcional. Se estiver faltando, a primeira linha não vazia será usada.
• argument-hint é opcional. Quando definida, a dica é exibida antes da descrição no menu suspenso de preenchimento automático.

Use argument-hint no frontmatter para mostrar os argumentos esperados no preenchimento automático. Use <angle brackets> para argumentos obrigatórios e [square brackets] para argumentos opcionais:

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

Isso é renderizado no menu suspenso de preenchimento automático 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

Digite / seguido do nome do modelo no editor. O preenchimento automático mostra os modelos disponíveis com descrições.

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

Os modelos suportam argumentos posicionais, padrões e fatiamento simples:

• $1, $2,... argumentos posicionais
• $@ ou $ARGUMENTS para todos os argumentos unidos
• ${1:-default} usa argumento 1 quando presente/não vazio, caso contrário default
• ${@:-default} ou ${ARGUMENTS:-default} usa todos os argumentos quando presentes/não vazios, caso contrário default
• ${@:N} para argumentos da enésima posição (indexado 1)
• ${@:N:L} para L argumentos começando em N

Exemplo:

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

Os valores padrão são úteis para argumentos opcionais:

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

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

• A descoberta de modelos em prompts/ não é recursiva.
• Se você quiser modelos em subdiretórios, adicione-os explicitamente através das configurações prompts ou de um manifesto de pacote.