Konfigurasi, kustomisasi, pengaturan platform, dan referensi API untuk Pi.

Templat Cepat

pi dapat membuat prompt templates. Mintalah untuk membuatkannya untuk alur kerja Anda.

Templat prompt adalah Markdown cuplikan yang diperluas menjadi perintah penuh. Ketik /name di editor untuk memanggil templat, dengan name adalah nama file tanpa .md.

Lokasi

Pi memuat prompt templates dari:

  • Global: ~/.pi/agent/prompts/*.md
  • Proyek: .pi/prompts/*.md (hanya setelah proyek dipercaya)
  • Paket: prompts/ direktori atau pi.prompts entri di package.json
  • Pengaturan: prompts array dengan file atau direktori
  • CLI: --prompt-template <path> (dapat diulang)

Nonaktifkan penemuan dengan --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
  • Nama file menjadi nama perintah. review.md menjadi /review.
  • description adalah opsional. Jika tidak ada, baris pertama yang tidak kosong digunakan.
  • argument-hint adalah opsional. Jika disetel, petunjuk akan ditampilkan sebelum deskripsi di dropdown pelengkapan otomatis.

Petunjuk Argumen

Gunakan argument-hint di frontmatter untuk menampilkan argumen yang diharapkan dalam pelengkapan otomatis. Gunakan <angle brackets> untuk argumen wajib dan [square brackets] untuk argumen opsional:

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

Ini ditampilkan dalam dropdown pelengkapan otomatis sebagai:

→ 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

Penggunaan

Ketik / diikuti dengan nama templat di editor. Pelengkapan otomatis menampilkan templat yang tersedia dengan deskripsi.

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

Argumen

Templat mendukung argumen posisi, default, dan pemotongan sederhana:

  • $1, $2,... argumen posisi
  • $@ atau $ARGUMENTS untuk semua argumen yang digabungkan
  • ${1:-default} menggunakan arg 1 saat ada/tidak kosong, jika tidak default
  • ${@:-default} atau ${ARGUMENTS:-default} menggunakan semua argumen saat ada/tidak kosong, jika tidak default
  • ${@:N} untuk argumen dari posisi ke-N (terindeks 1)
  • ${@:N:L} untuk L argumen dimulai dari N

Contoh:

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

Nilai default berguna untuk argumen opsional:

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

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

Memuat Aturan

  • Penemuan templat di prompts/ bersifat non-rekursif.
  • Jika Anda ingin templat dalam subdirektori, tambahkan secara eksplisit melalui pengaturan prompts atau manifes paket.