0:00 / 4:00
Кейс 3 · Доработка требований по комментариям

SpecFlow Review

GigaCode превращает комментарии в Confluence
в применённые правки требований — безопасно и с доказательствами.

$ gigacode › /refine <url страницы Confluence>
Проблема

Ревью требований съедает дни:
каждая правка переносится вручную

аналитик на 30-м комментарии · реконструкция; ни один аналитик не пострадал
«Уточните статусы!»
«А где роль администратора?»
«Это не то предложение…»
30+

комментариев на одной странице требований. Каждый — ручной поиск места, правка, ответ, новая версия.

Хуже всего — одинаковые фразы: правится не то вхождение.

Решение

Skill + 3 локальных скрипта:
комментарий → проверенная правка

A · Якоряparse_markers.js: markerRef → selectedText → порядок. Большие страницы — чанками
Классификация8 категорий замечаний: typo, «ответ уже в тексте», ambiguous…
A2 · Evidencebuild_context.js: RAG по связанным страницам с приоритетом свежести
B · Гибрид-ревьюправки auto-авторов — пакетом, остальные — по одной (a/e/r/s/n)
C · Applyapply_edits.js: сплайс в storage → dry-run → diff-проверка → ответы + audit

Модель никогда не трогает HTML страницы. Парсинг, контекст и применение — детерминированные скрипты без зависимостей: решение работает даже со слабыми LLM.

AI-ready формат

Не «ответ модели» — машинно-применимая операция

proposal · inline-comment #294948 AUTO_ACCEPTED 

    

  


  
  

    
Wow №1 · Точный якорь

    
Одинаковые фразы? Мы знаем, какую правит комментарий

    

      
Cancellation

      Пользователь может отменить операцию.
      
Refunds

      Пользователь может отменить операцию.ac:ref="8a60c342…"
      Средства возвращаются на исходную карту.
    

    

      1. markerRef — родной якорь Confluence в теле страницы
      2. selectedText + контекст до/после + occurrence
      3. неоднозначно → стоп и вопрос человеку
    

  


  
  

    
Wow №2 · Grounded знания

    
RAG по дереву страниц — близость × свежесть

    

      
        
        
        
        
        
        Business Rules
        parent · 0.9
        
        Glossary
        sibling · 0.6
        
        Requirements
        target page
        
        API Spec
        sibling · 0.6
        
        Notifications
        child · 0.8
      
      

        
EVIDENCE · Business Rules / Cancellation status rule · score 1.29 · обновлено 3 дня назад

        Отмена разрешена только в статусах NEW или APPROVED. EXECUTED-операции отменить нельзя.
        
Свежие страницы приоритетнее: вес затухает с возрастом — устаревшие требования не попадут в правку. Нет evidence — нет auto-apply.

      

    

  


  
  

    
Безопасность

    
Гибридная автономность: авто-применение — только когда пройдены все проверки

    

      
✓
Автор комментария в режиме auto + безопасная категория

      
✓
Якорь разрешён однозначно (markerRef)

      
✓
Evidence с точной цитатой и датой

      
✓
Нет конфликтов на одном маркере · версия не устарела

      
✓
После apply — проверка get_page_diff: ответы только по факту

      
✗
Любой сбой → needs_human, документ не тронут

    

    
ПАКЕТ ПОДТВЕРЖДЁН → APPLY v1 → v2 → DIFF OK → REPLY + AUDIT.JSON

  


  
  

    
Не слайды — работающий код

    
Закалено реальными сбоями и живым Confluence

    

      
0
зелёных тестов:
якоря, чанкинг, RAG, сплайс

      
0
классов реальных сбоев собрано
и закрыто механизмами

      
0
жёстких правил агента:
слабая LLM не сломает документ

      
0
зависимостей npm.
Чистый Node.js

    

    
Мы прогнали решение на живом Confluence 10.2 и собрали реальные сбои — markdown-перезапись страницы, сломанное экранирование &amp; в storage-формате, ложные ответы, правки сверх того, что просил комментарий — и каждый закрыли детерминированным механизмом, а не промптом.
Без сети? Встроенный mock-сервер с тем же REST-контрактом — демо никогда не падает.

  


  
  

    
Проверяемость

    
Мы тоже говорим громкие слова — но каждое можно проверить

    

      
У нас есть RAG

      
✓
RAG с приоритетом свежести + цитата-evidence в каждой правке. Нет evidence — нет auto-apply

      
Это безопасно

      
✓
Policy gate из 13 правил: любой сбой → needs_human, документ не тронут

      
Готово к прому

      
✓
Versioning · diff-проверка · audit.json · 50 тестов · офлайн mock — разворачивается за минуту

      
Модель справится сама

      
✗
Мы так не считаем: 6 классов реальных сбоев модели закрыты скриптами и проверками

    

    
ПАПКА skill/ ВОСПРОИЗВОДИТ ВСЁ ОФЛАЙН — ПРОВЕРЬТЕ САМИ

  


  
  

    
Переиспользование

    
Одни скрипты — три способа запуска и любой источник требований

    

      
GigaCode CLIкоманда /refine <url страницы Confluence>

      

      
GigaCode agent-modeправило — .gigacode/rules/confluence-review.md

      

      
Любой MCP-агент«прочитай skill/SKILL.md и следуй ему» — core-агент тоже

    

    

      Confluence — сегодня, в демо
      SDD — спеки в git, комментарии = PR-ревью
      Jira / SharePoint — любое хранилище с комментариями
    

    
Слои не зависят от источника: якоря, классификация, ревью и аудит переносимы. Для нового источника меняются только вход парсера и выход apply — минимальные доработки.
InSourceHub-ready: папка skill/ + тесты + офлайн-демо — любая команда AI PDLC забирает и развивает.

  


  
  

    
Команда · Департамент ИТ блока «Строительство»

    
Kirpich Crew — пять человек, ноль зависимостей

    

      
Алфимова ЕкатеринаАлфимова Екатерина

      
Бродкин ПавелБродкин Павел

      
Кравцов АндрейКравцов Андрей

      
Панченко ИванПанченко Иван

      
Чурбанов СергейЧурбанов Сергей

    

  


  
  

    

    
SpecFlow Review

    
Модель предлагает.
Скрипты применяют.
Дифф доказывает.

    

      точный якорь среди дубликатов
      большие страницы — чанками, без падений
      RAG с приоритетом свежести
      ответы только по проверенному диффу · audit каждой правки
      production-ready: versioning · audit.json · offline mock · 0 deps
    

  







  1 / 12