framework/skills/tool-usage/code-analysis/search-before-write/SKILL.md
Поиск перед записью (Search Before Write). Навык учит агента **всегда выполнять поиск перед написанием нового кода**.
npx skillsauth add steelmorgan/1c-agent-based-dev-framework search-before-writeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Любая задача на написание кода — прежде всего задача на поиск. Сначала ищем, потом пишем.
Каждый следующий шаг — только если предыдущий не дал результата:
| Шаг | Инструмент | Что ищем |
|-----|------------|----------|
| 1 | navigate_symbol (LSP) | Аналогичные функции/процедуры в проекте |
| 2 | list_metadata_objects, get_metadata_structure | Объекты конфигурации (справочники, регистры, документы) |
| 3 | search_syntax_reference, get_type_info | Встроенные типы/методы платформы |
| 4 | search_ssl_functions | Функции БСП (если конфигурация содержит БСП) |
| 5a | ask_ai_assistant (шаблон SEARCH_DOCS) | Документация платформы — если вопрос про API, методы, типы |
| 5b | ask_ai_assistant (шаблон SEARCH_ITS → FETCH_ITS) | Стандарты, методология, примеры ИТС — если вопрос про правила разработки |
| 5c | ask_ai_assistant (generic) | Прочие вопросы — только если 5a/5b не подходят |
Шаблоны промптов для шагов 5a–5c — см. навык
buddy-prompting.
| Задача | Начальный шаг каскада | |--------|-----------------------| | Новая функция/процедура | 1 — поиск аналогов по имени | | Бизнес-логика | 2 — поиск объектов метаданных | | Использование API платформы | 3 — справка синтаксиса; fallback 5a (документация) | | Печатная форма | 2 → 4 (метаданные + БСП API) | | Стандарты и правила разработки | 5b — поиск в ИТС | | Миграция между версиями | 5a (шаблон DIFF_VERSIONS) | | Запрос | 1 — существующие запросы в проекте |
| 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 пусто | Конфигурация загружена? v8-runner build (или v8-runner dump --mode incremental если ИБ — источник правды); проверить metaType/nameMask |
| navigate_symbol пусто | Уточнить имя (рус/лат, регистр); ask_ai_assistant (шаблон SEARCH_DOCS) |
| ask_ai_assistant пустой результат | Переформулировать query; см. правила в buddy-prompting |
| search_ssl_functions недоступен | Без БСП — search_syntax_reference + navigate_symbol по общим модулям |
tools
Diagnostics for Vanessa Automation runs. Use when a feature scenario failed, artifacts were not created, or you need to classify a failure after launch.
tools
Creating and refining Vanessa Automation feature scenarios based on real project requirements. Use when you need to write or update a scenario test, not just run it.
tools
--- name: v8-session-manager description: Use when working with the 1С session manager (v8-session-manager) - launch, configuration, connecting 1С clients, reading session_list, calling proxied MCP-tools from 1С extensions, diagnostics. Triggers: mention of `v8-session-manager`, `session_list`, 1С extension MCP showcase, error “no active sessions” / “session_id required”, connecting a client to the manager via `mcpMode=ws`. provides_capabilities: # Built-in manager tools — always available whi
tools
Use when Codex needs to manage v8-runner on local 1C projects through the CLI: configure v8project.yaml, initialize infobases or EDT workspaces, build sources from Designer or EDT, run syntax checks and tests, dump infobase changes, convert source formats, load or export artifacts, launch 1C clients, or choose safe 1C automation command sequences.