search-before-write

$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

SkillDescription
1c-ai-agent-cliCLI 1C BSL Agent Framework — tools/install.py (clone, install). Используй при клонировании репозитория, установке компонентов в проект, настройке IDE (Cursor, Claude Code, Windsurf, VS Code+Continue).
agent-debugПаттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
agent-developmentCreate 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-workflowStandardizes 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-bootstrapDeterministic 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-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.