Шаблоны подсказок

Пи может создать prompt templates. Попросите его создать его для вашего рабочего процесса.

Шаблоны подсказок — это Markdown фрагменты, которые расширяются до полных подсказок. Введите /name в редакторе, чтобы вызвать шаблон, где name — имя файла без .md.

Pi загружает prompt templates из:

• Глобально: ~/.pi/agent/prompts/*.md
• Проект: .pi/prompts/*.md (только после того, как проекту доверяют)
• Пакеты: prompts/ каталогов или pi.prompts записей в package.json.
• Настройки: prompts массив с файлами или каталогами.
• CLI: --prompt-template <path> (повторяемый)

Отключите обнаружение с помощью --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

• Имя файла становится именем команды. review.md становится /review.
• description не является обязательным. Если оно отсутствует, используется первая непустая строка.
• argument-hint не является обязательным. Если этот параметр установлен, подсказка отображается перед описанием в раскрывающемся списке автозаполнения.

Используйте argument-hint во вступительной части, чтобы отобразить ожидаемые аргументы при автозаполнении. Используйте <angle brackets> для обязательных аргументов и [square brackets] для необязательных:

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

Это отображается в раскрывающемся списке автозаполнения как:

→ 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

Введите /, а затем имя шаблона в редакторе. Автозаполнение показывает доступные шаблоны с описаниями.

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

Шаблоны поддерживают позиционные аргументы, значения по умолчанию и простую нарезку:

• $1, $2,... позиционные аргументы
• $@ или $ARGUMENTS для всех соединенных аргументов
• ${1:-default} использует аргумент 1, если он присутствует/непустой, в противном случае default
• ${@:-default} или ${ARGUMENTS:-default} использует все аргументы, если они присутствуют/не пусты, в противном случае default
• ${@:N} для аргументов с N-й позиции (с индексом 1)
• ${@:N:L} для L аргументов, начиная с N

Пример:

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

Значения по умолчанию полезны для необязательных аргументов:

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

Использование: /component Button "onClick handler" "disabled support"

• Обнаружение шаблонов в prompts/ нерекурсивно.
• Если вам нужны шаблоны в подкаталогах, добавьте их явно через настройки prompts или манифест пакета.