Cấu hình, tùy chỉnh, thiết lập nền tảng và tham chiếu API cho Pi.

Mẫu nhắc nhở

pi có thể tạo prompt templates. Yêu cầu nó xây dựng một cái cho quy trình làm việc của bạn.

Mẫu lời nhắc là Markdown đoạn trích mở rộng thành lời nhắc đầy đủ. Nhập /name vào trình chỉnh sửa để gọi mẫu, trong đó name là tên tệp không có .md.

Địa điểm

Pi tải prompt templates từ:

  • Toàn cầu: ~/.pi/agent/prompts/*.md
  • Dự án: .pi/prompts/*.md (chỉ sau khi dự án được tin cậy)
  • Các gói: prompts/ thư mục hoặc pi.prompts mục trong package.json
  • Cài đặt: mảng prompts với các tệp hoặc thư mục
  • CLI: --prompt-template <path> (có thể lặp lại)

Tắt tính năng khám phá bằng --no-prompt-templates.

Định dạng

---
description: Review staged git changes
---
Review the staged changes (`git diff --cached`). Focus on:
- Bugs and logic errors
- Security issues
- Error handling gaps
  • Tên tập tin trở thành tên lệnh. review.md trở thành /review.
  • description là tùy chọn. Nếu thiếu, dòng không trống đầu tiên sẽ được sử dụng.
  • argument-hint là tùy chọn. Khi được đặt, gợi ý sẽ hiển thị trước phần mô tả trong danh sách thả xuống tự động hoàn thành.

Gợi ý lập luận

Sử dụng argument-hint trong phần đầu để hiển thị các đối số dự kiến ​​trong tính năng tự động hoàn thành. Sử dụng <angle brackets> cho các đối số bắt buộc và [square brackets] cho các đối số tùy chọn:

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

Điều này hiển thị trong danh sách thả xuống tự động hoàn thành dưới dạng:

→ 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

Cách sử dụng

Nhập / theo sau là tên mẫu trong trình chỉnh sửa. Tự động hoàn thành hiển thị các mẫu có sẵn cùng với mô tả.

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

Đối số

Các mẫu hỗ trợ các đối số vị trí, mặc định và cắt lát đơn giản:

  • $1, $2,... đối số vị trí
  • $@ hoặc $ARGUMENTS cho tất cả các đối số đã tham gia
  • ${1:-default} sử dụng arg 1 khi hiện diện/không trống, nếu không thì default
  • ${@:-default} hoặc ${ARGUMENTS:-default} sử dụng tất cả đối số khi có/không trống, nếu không thì default
  • ${@:N} cho các đối số từ vị trí thứ N (được lập chỉ mục 1)
  • ${@:N:L} cho L đối số bắt đầu từ N

Ví dụ:

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

Các giá trị mặc định rất hữu ích cho các đối số tùy chọn:

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

Cách sử dụng: /component Button "onClick handler" "disabled support"

Đang tải quy tắc

  • Khám phá mẫu trong prompts/ là không đệ quy.
  • Nếu bạn muốn các mẫu trong thư mục con, hãy thêm chúng một cách rõ ràng thông qua cài đặt prompts hoặc bảng kê khai gói.