Pi için yapılandırma, özelleştirme, platform kurulumu ve API referansları.

Bilgi İstemi Şablonları

pi prompt templates oluşturabilir. İş akışınız için bir tane oluşturmasını isteyin.

Bilgi istemi şablonları, tam istemlere genişleyen Markdown parçacıklardır. Bir şablonu çağırmak için düzenleyiciye /name yazın; burada name, .md olmadan dosya adıdır.

Konumlar

Pi şuradan prompt templates yükler:

  • Küresel: ~/.pi/agent/prompts/*.md
  • Proje: .pi/prompts/*.md (yalnızca projeye güvenildikten sonra)
  • Paketler: prompts/ dizinler veya package.json içindeki pi.prompts girişler
  • Ayarlar: prompts dosya veya dizin içeren dizi
  • CLI: --prompt-template <path> (tekrarlanabilir)

--no-prompt-templates ile keşfi devre dışı bırakın.

Biçim

---
description: Review staged git changes
---
Review the staged changes (`git diff --cached`). Focus on:
- Bugs and logic errors
- Security issues
- Error handling gaps
  • Dosya adı komut adı olur. review.md, /review olur.
  • description isteğe bağlıdır. Eksikse boş olmayan ilk satır kullanılır.
  • argument-hint isteğe bağlıdır. Ayarlandığında ipucu, otomatik tamamlama açılır menüsündeki açıklamadan önce görüntülenir.

Tartışma İpuçları

Otomatik tamamlamada beklenen bağımsız değişkenleri göstermek için ön maddede argument-hint kullanın. Gerekli argümanlar için <angle brackets> ve isteğe bağlı olanlar için [square brackets] kullanın:

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

Bu, otomatik tamamlama açılır menüsünde şu şekilde görüntülenir:

→ 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

Kullanım

Düzenleyicide / ve ardından şablon adını yazın. Otomatik tamamlama, mevcut şablonları açıklamalarla birlikte gösterir.

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

Argümanlar

Şablonlar konumsal argümanları, varsayılanları ve basit dilimlemeyi destekler:

  • $1, $2,... konumsal argümanlar
  • Birleştirilen tüm bağımsız değişkenler için $@ veya $ARGUMENTS
  • ${1:-default} mevcut/boş olmadığında argüman 1'i kullanır, aksi halde default
  • ${@:-default} veya ${ARGUMENTS:-default} mevcut/boş olmadığında tüm argümanları kullanır, aksi takdirde default
  • ${@:N} N'inci konumdan bağımsız değişkenler için (1 dizinli)
  • ${@:N:L} N'den başlayan L argümanlar için

Örnek:

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

Varsayılan değerler isteğe bağlı bağımsız değişkenler için kullanışlıdır:

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

Kullanım: /component Button "onClick handler" "disabled support"

Kurallar Yükleniyor

  • prompts/'deki şablon keşfi yinelemeli değildir.
  • Alt dizinlerde şablonlar istiyorsanız bunları prompts ayarları veya paket bildirimi yoluyla açıkça ekleyin.