Konfiguration, Anpassung, Plattform-Einrichtung und API-Referenzen für Pi.

Eingabeaufforderungsvorlagen

pi kann prompt templates erstellen. Bitten Sie es, eines für Ihren Workflow zu erstellen.

Eingabeaufforderungsvorlagen sind Markdown Snippets, die sich zu vollständigen Eingabeaufforderungen erweitern lassen. Geben Sie /name in den Editor ein, um eine Vorlage aufzurufen, wobei name der Dateiname ohne .md ist.

Standorte

Pi lädt prompt templates von:

  • Global: ~/.pi/agent/prompts/*.md
  • Projekt: .pi/prompts/*.md (nur nachdem das Projekt vertrauenswürdig ist)
  • Pakete: prompts/ Verzeichnisse oder pi.prompts Einträge in package.json
  • Einstellungen: prompts Array mit Dateien oder Verzeichnissen
  • CLI: --prompt-template <path> (wiederholbar)

Deaktivieren Sie die Erkennung mit --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
  • Der Dateiname wird zum Befehlsnamen. review.md wird zu /review.
  • description ist optional. Bei Fehlen wird die erste nicht leere Zeile verwendet.
  • argument-hint ist optional. Wenn festgelegt, wird der Hinweis vor der Beschreibung im Dropdown-Menü für die automatische Vervollständigung angezeigt.

Argumentationshinweise

Verwenden Sie argument-hint in frontmatter, um erwartete Argumente bei der automatischen Vervollständigung anzuzeigen. Verwenden Sie <angle brackets> für erforderliche Argumente und [square brackets] für optionale:

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

Dies wird im Dropdown-Menü für die automatische Vervollständigung wie folgt dargestellt:

→ 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

Verwendung

Geben Sie im Editor / gefolgt vom Namen der Vorlage ein. Die automatische Vervollständigung zeigt verfügbare Vorlagen mit Beschreibungen an.

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

Argumente

Vorlagen unterstützen Positionsargumente, Standardwerte und einfaches Slicing:

  • $1, $2,... Positionsargumente
  • $@ oder $ARGUMENTS für alle verbundenen Argumente
  • ${1:-default} verwendet arg 1, wenn vorhanden/nicht leer, andernfalls default
  • ${@:-default} oder ${ARGUMENTS:-default} verwendet alle Argumente, wenn vorhanden/nicht leer, andernfalls default
  • ${@:N} für Argumente ab der N-ten Position (1-indiziert)
  • ${@:N:L} für L Argumente beginnend bei N

Beispiel:

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

Standardwerte sind für optionale Argumente nützlich:

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

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

Laderegeln

  • Die Vorlagenerkennung in prompts/ ist nicht rekursiv.
  • Wenn Sie Vorlagen in Unterverzeichnissen wünschen, fügen Sie diese explizit über prompts-Einstellungen oder ein Paketmanifest hinzu.