Repolode
ShadowSwaps

ShadowSwaps/REA-Reconstruction-Companion

Открытый навык для AI-агентов, который помогает разобраться в существующем ПО, спланировать его реконструкцию и проверить результат с помощью REA.

Звёзды
131
Форки
22
Открытые issues
0
Последний коммит
8 дней назад

Что это?

REA-Reconstruction-Companion — независимый от модели навык для AI-агентов, оформленный как инструкции и справочные материалы в Markdown в формате Agent Skills. Он помогает агенту разобраться в поведении существующего ПО, преобразовать наблюдения в требования и поэтапный план, а затем реализовать выбранную часть — только по прямому запросу. На каждом этапе наблюдаемое поведение отделяется от выводов и проектных решений, а пробелы в данных фиксируются, а не заполняются предположением, что реконструкция совпадает с оригиналом.

Навык рассчитан на работу в паре с REA, который предоставляет инструменты для изучения ПО и сбора свидетельств. Компаньон помогает тому же агенту использовать эти свидетельства для формирования требований, проектирования, реализации и проверки. В комплект входит установщик для Node.js 20+, поддерживающий Claude Code, Codex и универсальные клиенты; предусмотрены предварительный просмотр в режиме dry-run, проверка и создание резервных копий. При включении необязательной интеграции с REA в файл навыка REA добавляется помеченное правило, благодаря которому при подходящих запросах на реконструкцию также загружается компаньон.

В проекте также заданы явные ограничения на расходы и разрешения: агенту запрещено запускать действия, которые могут повлечь расходы, а любой шаг пропускается, если невозможно подтвердить, что он не требует оплаты. Необязательная проверка обновлений, отключённая по умолчанию, запускается не чаще одного раза в семь дней; перед установкой новой версии всё равно требуется подтверждение пользователя.

Ключевые возможности

  • 01Преобразует наблюдения, файлы и записи в описания поведения, требования и список открытых вопросов.
  • 02Формирует спецификации и поэтапные планы реконструкции с критериями приёмки, привязанными к свидетельствам.
  • 03Реализует выбранное поведение небольшими проверяемыми итерациями — только по запросу на реализацию.
  • 04Содержит рекомендации по проверке, включая дифференциальный фаззинг, мутационные тесты и контракты интерфейсов.
  • 05Установщик поддерживает Claude Code, Codex и каталоги навыков общего назначения, а также режимы dry-run и проверки.
  • 06Необязательная интеграция с REA добавляет в файл навыка REA обратимое правило маршрутизации.

Сценарии использования

  • Разобраться, как существующее настольное или веб-приложение выполняет сохранение, редактирование или импорт, прежде чем планировать аналогичный инструмент.
  • Спланировать реконструкцию отдельной функции или формата файлов, задокументировав входные и выходные данные и случаи ошибок.
  • Воссоздать выбранный сценарий работы в локальном проекте и сообщить о непроверенных различиях.
  • Восстановить и изменить существующую реконструкцию, сохранив совместимость с предыдущими наработками.

Быстрый старт

  1. 1

    Скачайте или клонируйте репозиторий с GitHub

  2. 2

    Установите дополнение для Claude Code, не изменяя REA

    node install.mjs --client claude-code --integration off
  3. 3

    Просмотрите изменения перед установкой (необязательно)

    node install.mjs --client claude-code --integration off --dry-run
  4. 4

    Проверьте установку

    node install.mjs --client claude-code --integration off --check

Что важно знать

  • Для запуска установщика требуется Node.js версии 20 или новее.
  • Для исследования в реальном времени необходимо отдельно установить и настроить REA для вашего клиента.
  • Установить его через клиенты, поддерживающие только чат или размещённую загрузку, нельзя.

В подборках

Темы

Частые вопросы

Что такое REA-Reconstruction-Companion?
Открытый навык для AI-агентов, который помогает разобраться в существующем ПО, спланировать его реконструкцию и проверить результат с помощью REA. REA-Reconstruction-Companion — независимый от модели навык для AI-агентов, оформленный как инструкции и справочные материалы в Markdown в формате Agent Skills. Он помогает агенту разобраться в поведении существующего ПО, преобразовать наблюдения в требования и поэтапный план, а затем реализовать выбранную часть — только по прямому запросу. На каждом этапе наблюдаемое поведение отделяется от выводов и проектных решений, а пробелы в данных фиксируются, а не заполняются предположением, что реконструкция совпадает с оригиналом.
REA-Reconstruction-Companion можно использовать бесплатно? Какая у него лицензия?
REA-Reconstruction-Companion распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
REA-Reconstruction-Companion всё ещё поддерживается?
Активно поддерживается. Последний коммит в REA-Reconstruction-Companion — 30 окт. 2026 г..
Для чего можно использовать REA-Reconstruction-Companion?
Разобраться, как существующее настольное или веб-приложение выполняет сохранение, редактирование или импорт, прежде чем планировать аналогичный инструмент. Спланировать реконструкцию отдельной функции или формата файлов, задокументировав входные и выходные данные и случаи ошибок. Воссоздать выбранный сценарий работы в локальном проекте и сообщить о непроверенных различиях. Восстановить и изменить существующую реконструкцию, сохранив совместимость с предыдущими наработками.
Как установить REA-Reconstruction-Companion?
Скачайте или клонируйте репозиторий с GitHub Установите дополнение для Claude Code, не изменяя REA: node install.mjs --client claude-code --integration off Просмотрите изменения перед установкой (необязательно): node install.mjs --client claude-code --integration off --dry-run Проверьте установку: node install.mjs --client claude-code --integration off --check
Где скачать REA-Reconstruction-Companion?
Исходный код и инструкции по установке — на GitHub: https://github.com/ShadowSwaps/REA-Reconstruction-Companion

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Мультиплатформенный хук и набор правил для AI-агентов, который блокирует незапрошенные хеши и контрольные суммы, а также отклонение от задачи в Codex, Claude Code, OpenCode и других средах.

3,7 тыс.+281 за неделю76JavaScriptMITАктивно поддерживаетсяОбновлён позавчера