search-before-write

---
name: search-before-write
description: Поиск перед записью (Search Before Write). Навык учит агента **всегда выполнять поиск перед написанием нового кода**.
---

# Поиск перед записью (Search Before Write)

Любая задача на написание кода — прежде всего задача на поиск. Сначала ищем, потом пишем.

## Каскад поиска

Каждый следующий шаг — только если предыдущий не дал результата:

| Шаг | Инструмент | Что ищем |
|-----|------------|----------|
| 1 | `navigate_symbol` (LSP) | Аналогичные функции/процедуры в проекте |
| 2 | `list_metadata_objects`, `get_metadata_structure` | Объекты конфигурации (справочники, регистры, документы) |
| 3 | `search_syntax_reference`, `get_type_info` | Встроенные типы/методы платформы |
| 4 | `search_ssl_functions` | Функции БСП (если конфигурация содержит БСП) |
| 5 | `ask_ai_assistant` | Best practices, шаблоны (если каскад 1–4 не дал результата) |

## Триггеры

| Задача | Начальный шаг каскада |
|--------|-----------------------|
| Новая функция/процедура | 1 — поиск аналогов по имени |
| Бизнес-логика | 2 — поиск объектов метаданных |
| Использование API платформы | 3 — справка синтаксиса |
| Печатная форма | 2 → 4 (метаданные + БСП API) |
| Запрос | 1 — существующие запросы в проекте |

## Capabilities

| Capability | Назначение |
|------------|------------|
| `navigate_symbol` | Поиск символов, определение, использования |
| `list_metadata_objects` | Объекты метаданных по типу и маске |
| `get_metadata_structure` | Структура объекта (реквизиты, измерения, ресурсы) |
| `search_syntax_reference` | Справка синтаксиса платформы |
| `get_type_info` | Детали типов платформы |
| `search_ssl_functions` | Функции БСП |
| `ask_ai_assistant` | Best practices, шаблоны |

## Типичные ошибки

| Ошибка | Обходной путь |
|--------|---------------|
| Пропуск поиска | Жёсткое правило: создание кода → первый шаг = поиск |
| `list_metadata_objects` пусто | Конфигурация загружена? `dump_config`; проверить metaType/nameMask |
| `navigate_symbol` пусто | Уточнить имя (рус/лат, регистр); `ask_ai_assistant` |
| `search_ssl_functions` недоступен | Без БСП — `search_syntax_reference` + `navigate_symbol` по общим модулям |

---
depends_on: []
---