Prompt Files (.prompt)¶

# YAML-преамбула (опционально)
---
name: my-prompt
description: Описание промпта
version: 2
---

# Тело промпта
Текст инструкции для LLM...

---
name: explain
description: Explain code
---

Explain the following code in simple terms:

{{ code }}

Include:
- What the code does
- How it works
- Potential improvements

{{ input }}    — пользовательский ввод
{{ code }}     — выделенный код
{{ file }}     — текущий файл

{{#if input}}
Additional requirements: {{ input }}
{{else}}
No additional requirements provided.
{{/if}}

{{#unless framework}}
No specific framework requested.
{{/unless}}

{{#each items}}
- {{ this }}
{{/each}}

---
name: refactor
description: Refactor code
---

Refactor the following code to improve readability:

{{ code }}

Provide the refactored version with explanations.

---
name: analyze
description: Analyze file
---

Analyze the structure and quality of this file:

{{ file }}

Suggest improvements for:
- Code organization
- Naming conventions
- Error handling
- Performance

---
name: improve
description: Improve code
---

Improve the code based on these requirements:

**Requirements:** {{ input }}

**Code:**
{{ code }}

---
name: full-review
description: Full project review
---

Review the code considering the project structure:

@README.md
@src/main.py
@package.json

Focus on consistency and best practices.

@src/utils/helper.py           # Относительно корня workspace
@../shared/types.ts            # Относительно текущей папки
@/Users/me/project/config.yaml # Абсолютный путь

@https://docs.example.com/api  # Веб-страница
@https://github.com/repo/file  # GitHub файл

@currentFile    # Текущий файл
@terminal       # Вывод терминала
@os             # Информация об ОС
@repo-map       # Карта репозитория
@diff           # Текущие изменения

---
name: expert-coder
description: Expert coding assistant
---

<system>
You are an expert software engineer with deep knowledge of:
- Software architecture
- Design patterns
- Best practices
- Security considerations

Always provide clear, well-structured answers with code examples.
</system>

{{ code }}

---
name: review
description: Comprehensive code review
version: 2
---

<system>
You are a senior code reviewer with expertise in:
- Code quality
- Security
- Performance
- Maintainability
</system>

Review the following code:

{{ code }}

{{#if input}}
Focus especially on: {{ input }}
{{/if}}

Provide feedback on:
1. **Bugs and errors** - Identify any potential issues
2. **Security** - Check for vulnerabilities
3. **Performance** - Suggest optimizations
4. **Style** - Code consistency and readability
5. **Best practices** - Industry standards adherence

For each issue, provide:
- Severity (Critical/High/Medium/Low)
- Description
- Suggested fix

---
name: test
description: Generate unit tests
version: 2
---

Generate comprehensive unit tests for the following code:

{{ code }}

{{#if framework}}
Use {{ framework }} testing framework.
{{else}}
Use appropriate testing framework for the language.
{{/if}}

{{#if input}}
Additional requirements:
{{ input }}
{{/if}}

Include:
- Happy path tests
- Edge cases
- Error handling
- Mock external dependencies

Provide tests ready to run.

---
name: document
description: Add documentation
version: 2
---

Add comprehensive documentation to the code:

{{ code }}

{{#if language}}
Use {{ language }} documentation conventions.
{{else}}
Use standard documentation conventions.
{{/if}}

Include:
- Module/file-level docstring
- Function/method docstrings
- Parameter descriptions (@param)
- Return value descriptions (@returns)
- Exception documentation (@throws)
- Usage examples

@README.md

---
name: refactor
description: Refactor code
version: 2
---

Refactor the following code to improve:

{{ code }}

{{#if input}}
Focus areas:
{{ input }}
{{else}}
Focus areas:
- Readability
- Maintainability
- Performance
- SOLID principles
{{/if}}

Provide:
1. Analysis of current issues
2. Refactored code
3. Explanation of changes
4. Migration notes if breaking changes

@src/**/*.py

---
name: generate
description: Generate code from specification
version: 2
---

Generate code based on the specification:

{{#if input}}
**Specification:**
{{ input }}
{{else}}
**Specification:** (not provided - ask for clarification)
{{/if}}

{{#if language}}
**Target language:** {{ language }}
{{/if}}

{{#if framework}}
**Framework:** {{ framework }}
{{/if}}

Requirements:
- Follow best practices
- Include error handling
- Add type hints
- Write self-documenting code
- Include usage examples

@package.json

---
name: debug
description: Debug an issue
version: 2
---

Help debug the following issue:

{{#if input}}
**Problem description:**
{{ input }}
{{/if}}

**Code:**
{{ code }}

{{#if error}}
**Error message:**
{{ error }}
{{/if}}

@terminal

Steps to diagnose:
1. Analyze the error message
2. Identify root cause
3. Suggest potential fixes
4. Provide corrected code

---
name: optimize
description: Optimize performance
version: 2
---

Analyze and optimize the performance of:

{{ code }}

{{#if input}}
**Specific concerns:**
{{ input }}
{{/if}}

Focus on:
- Time complexity
- Space complexity
- Memory usage
- Unnecessary operations
- Caching opportunities
- Algorithm improvements

Provide:
1. Performance analysis
2. Bottleneck identification
3. Optimized code
4. Benchmarking suggestions

---
name: full-analysis
description: Complete code analysis
---

@./.koda/prompts/review.prompt
@./.koda/prompts/security.prompt
@./.koda/prompts/performance.prompt

Provide a consolidated report.

{{> common-instructions }}

{{ code }}

---
name: pr-review
description: Pull request review
---

Review this pull request:

@diff
@currentFile
@README.md

{{#if input}}
**PR description:**
{{ input }}
{{/if}}

Check for:
- Code quality
- Test coverage
- Documentation updates
- Breaking changes

# ✅ Хорошо: отдельные файлы для разных задач
.koda/prompts/
  review.prompt
  test.prompt
  document.prompt
  refactor.prompt

# ✅ Хорошо: понятное имя и описание
---
name: security-audit
description: Security-focused code audit
---

# ✅ Хорошо: чёткая структура
<system>Role definition</system>

Context:
{{ code }}

Task:
{{ input }}

Output format:
- Analysis
- Findings
- Recommendations

# ✅ Хорошо: переиспользование через @
@./.koda/prompts/common-review-section.prompt

# ❌ Плохо: огромный промпт
# Разбейте на несколько файлов

# ❌ Плохо: абсолютные пути
@/Users/username/specific/path/file.py

# ✅ Хорошо: относительные пути
@src/file.py

# ❌ Плохо: дублирование контекста
{{ code }}
{{ code }}
{{ file }}  # если file == code

# ✅ Хорошо: только необходимый контекст
{{ code }}

---
name: test-debug
description: Debug test
---

**Debug info:**
- Input: {{ input }}
- Code length: {{ code.length }}
- Available context: {{ this }}

{{ code }}

---
name: debug-vars
description: Debug variable substitution
---

**Variables:**
{{#if input}}
- input: {{ input }}
{{/if}}

{{#if code}}
- code: [{{ code.length }} chars]
{{/if}}

{{#if file}}
- file: {{ file }}
{{/if}}

---
name: complex-task
description: Complex analysis
model: claude-3-7-sonnet
temperature: 0.3
---

Perform detailed analysis...

---
name: terminal-debug
description: Debug with terminal
---

Analyze the terminal output:

@terminal

{{ code }}

Identify the issue and suggest fixes.

name: Example
---

Explain: {{{ input }}}

---
name: Example
version: 2
---

Explain: {{ input }}