search-before-write

Name: search-before-write
Author: SteelMorgan/1c-agent-based-dev-framework

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/search-before-write

Ensures agents search for existing code and platform resources before writing new code to avoid duplication and leverage best practices.

Helps prevent redundant code creation by finding existing implementations and platform features.
Integrates with LSP navigation, metadata tools, syntax references, BSP functions, and AI assistants.
Follows a prioritized cascade from project symbols to AI assistance based on task triggers.
Delivers results through structured tool outputs and recommendations for code reuse.

SKILL.md

.github/skills/search-before-writeView on GitHub ↗

---
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: []
---

More from SteelMorgan/1c-agent-based-dev-framework

Skill	Description
1c-ai-agent-cli	CLI 1C BSL Agent Framework — tools/install.py (clone, install). Используй при клонировании репозитория, установке компонентов в проект, настройке IDE (Cursor, Claude Code, Windsurf, VS Code+Continue).
agent-debug	Паттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
agent-development	Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.
agent-development-ext	>
agent-git-workflow	Standardizes git workflow for the AI agent in the sandbox devcontainer: work in agent/<task>-<yyyymmdd>, integrate via agent, never push to main/master, open PRs via GitHub CLI. Use when the user asks to create branches, push changes, open PRs, or follow this sandbox repo setup.
auto-skill-bootstrap	Deterministic helper to inventory existing project skills, detect missing capability coverage, search skills.sh via Skills CLI, and (optionally) install missing skills under a trust policy. Uses skills-manifest.json + state.json to stay idempotent across changing requirements.
code-navigation	Навигация по коду (Code Navigation). Навык учит агента эффективно перемещаться по BSL-коду с помощью LSP (Language Server Protocol).
config-operations	Операции с конфигурацией 1С (CF) — init, info, edit, validate. Используй при создании конфигурации, анализе структуры, изменении свойств и ChildObjects, валидации Configuration.xml.
epf-build	Собрать EPF/ERF из XML-исходников. Используй после внесения временных диагностических правок в разобранную обработку.
epf-dump	Разобрать EPF/ERF в XML-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.