analyze-1c-task-v2

--- name: analyze-1c-task-v2 description: > 5-фазная методология анализа задачи 1С:Предприятие. Требования -> Объекты -> Алгоритм -> План -> Верификация. v3.0: Итеративный режим с 3 агентами (Executor + Reviewer + Comparator). version: 3.0.0 updated: 2026-03-21 tags: [1c, analysis, bsl, configuration, methodology, semantic-search, autoresearch, three-agent] ultrathink: true commands: - /analyze-1c-task-v2 - /analyze-1c-task:research --- # Анализ задачи 1С — 5-фазная методология (v3.0) ## Overview Skill для комплексного анализа задачи по конфигурации 1С:Предприятие. На входе — ТЗ (описание задачи). На выходе — ANALYSIS-REPORT.md с пронумерованными точками модификации, готовый для передачи в implement-1c-task. **Улучшения v2 (D:С-Framework):** - Семантический поиск по 3,900+ BSL-модулям (bsl-semantic-search) - Поиск в индексированной документации 1С:8.3.27 (pdf-vector-graph) - API платформы 1С (bsl-platform-context) — типы, методы, свойства - Дешёвый LLM для подзадач анализа (llm-rotation) - 3 слоя памяти для накопления опыта **Улучшения v2.1:** - Обязательный поиск паттернов и существующего функционала в конфигурации - Верификация имён полей через get_metadata - Подготовка комментариев с номером задачи в плане ## ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА АНАЛИЗА ### Правило 1: Ориентироваться на существующий код конфигурации При анализе задачи ОБЯЗАТЕЛЬНО: 1. **Искать аналогичный функционал** — через bsl-semantic-search и Grep найти похожие реализации в конфигурации 2. **Использовать готовые функции** — если в конфигурации уже есть функция, решающая часть задачи, использовать её, а НЕ писать свою 3. **Следовать паттернам** — стиль именования, структура запросов, подходы к решению берутся из существующего кода 4. **Указывать в плане** — для каждой точки модификации указать, какой существующий код использован как образец ### Правило 2: Верификация имён полей Для КАЖДОГО SQL-запроса в плане: - Проверить имена полей через `get_metadata` (1c-mcp-toolkit) - Обратить внимание на префикс `гкс_` — может быть или не быть - Указать проверенные имена полей в отчёте ### Правило 3: Подготовка к реализации В ANALYSIS-REPORT обязательно указать: - Номер задачи (GKSTCPLK-XXXX) для комментариев в коде - Точные строки вставки (проверенные по текущему коду) - Зависимости между точками модификации - Порядок выполнения ## 5 фаз анализа ### Фаза 1: Требования - Разбор ТЗ на конкретные требования - Определение scope (что менять, что НЕ менять) ### Фаза 2: Объекты конфигурации - Список объектов, требующих изменений - Список объектов-источников данных (только чтение) - Структура регистров/документов через get_metadata ### Фаза 3: Алгоритм - **ПОИСК ПАТТЕРНОВ**: через bsl-semantic-search найти аналогичные реализации - Логика решения (с учётом найденных паттернов) - SQL-запросы (с проверенными именами полей) - Обработка граничных условий ### Фаза 4: План модификаций - Пронумерованные точки модификации - Для каждой: файл, строка, действие, код, зависимости - Порядок выполнения - Указание образцов из конфигурации для каждой точки ### Фаза 5: Верификация - Проверка покрытия всех требований - Проверка побочных эффектов - Тест-план - Верификация на реальных данных (если доступна база) ## Выходной формат: ANALYSIS-REPORT.md ```markdown # НОМЕР-ЗАДАЧИ Описание задачи ## 1. Описание задачи ### 1.1 Требования ### 1.2 Суть проблемы ## 2. Задействованные объекты конфигурации ### 2.1 Основные объекты (требуют изменения) ### 2.2 Объекты-источники данных ## 3. Детальный анализ механизма ### 3.X Найденные паттерны в конфигурации <-- ОБЯЗАТЕЛЬНО ## 4. План изменений ### Точка модификации N: ... - Файл, строка, действие, код - Образец из конфигурации: <ссылка на аналогичный код> ### Порядок выполнения ## 5. Чек-лист верификации ## 6. Риски и открытые вопросы ## 7. Тест-план ## 8. Верификация по коду (если проводилась) ## 9. Резюме ## 10. Верификация на реальных данных (если проводилась) ``` ## Инструменты - **bsl-semantic-search** — поиск аналогичного кода в конфигурации (ОБЯЗАТЕЛЬНО) - **1c-mcp-toolkit** — get_metadata для структуры объектов, execute_query для верификации - **bsl-platform-context** — API платформы 1С - **Serena** — символьный анализ кода - **Grep/Glob** — поиск файлов и паттернов ## Итеративный режим: /analyze-1c-task:research ### Принцип Executor (фазы 1-4) -> Reviewer (фаза 5 + scoring) -> fix gaps -> repeat. Три агента с разделением обязанностей (адаптация AutoResearch v2). ### Метрика: Analysis Quality Score (0-100) | Компонент | Вес | Источник | |-----------|-----|----------| | Requirements coverage | 30% | Маркеры [REQ-N] в плане | | Fields verified | 25% | Маркеры `✓ get_metadata` | | Patterns found | 20% | Маркеры `✓ pattern` | | SQL validated | 15% | Маркеры `✓ execute_query` | | Open questions | 10% | Секция 6 | ### Маркеры (обязательны для scoring) ``` ✓ get_metadata — поле проверено через MCP ✗ не проверено — поле не проверено (gap) ✓ pattern — найден образец из конфигурации ✓ execute_query — SQL валидирован на реальных данных [REQ-N] — привязка к требованию N ``` ### Стоп-условия - Score >= 85 (target) - 3 итерации без улучшения (plateau) - Max 7 итераций - Все gaps = 0 ### Как запускается **Интерактивный (в Claude Code):** ``` /analyze-1c-task:research GKSTCPLK-1234: Добавить расчёт суммы НДС по маршрутным листам ``` Claude выполняет Executor (main context) -> Reviewer (Agent subagent) -> fix -> repeat. **Headless (скрипт):** ```powershell .\scripts\analyze-1c-research.ps1 -TaskFile docs/tasks/GKSTCPLK-1234.md -TargetScore 85 ``` **Автономный (Ralph):** ```bash scripts\ralph.bat --template 1c-analysis --task docs/tasks/GKSTCPLK-1234.md ``` ### Протокол интерактивного режима 1. Создать сессию: `data/analyze-1c-research/{task-id}/` 2. **EXECUTOR** (main context): полный 5-фазный анализ -> analysis-report.md 3. **Цикл** (max 7 итераций): a. REVIEWER (Agent subagent): scorer + verify + gaps -> verdict b. Если score >= target -> DONE c. Если plateau >= 3 -> DONE d. Показать: "Score: N/100. K gaps. Verdict." e. EXECUTOR (main): Fix ONE gap из reviewer feedback f. Каждые 3 итерации: COMPARATOR (Agent subagent) 4. Финальный git commit: `[ANALYSIS] {task-id}: score {N}` ### Выходной формат с маркерами ```markdown ## 2. Задействованные объекты конфигурации ### 2.1 Основные объекты (требуют изменения) - Документ.МаршрутныйЛист — поле СуммаНДС ✓ get_metadata - РегистрНакопления.Движения — поле Сумма ✗ не проверено ## 4. План изменений ### Точка модификации 1: Добавить реквизит [REQ-1] - Образец: Документ.ЗаказНаПеревозку.СуммаНДС ✓ pattern - SQL: ` ``sql ВЫБРАТЬ СуммаНДС ИЗ Документ.МаршрутныйЛист ` `` ✓ execute_query ## Метаданные анализа - Score: 87/100 - Iterations: 4 - Session: data/analyze-1c-research/GKSTCPLK-1234/ ```