Oracle

Oracle

Oracle — это CLI-инструмент, который объединяет ваш промпт и релевантные файлы проекта в единый запрос, чтобы другая модель могла дать ответ с полноценным контекстом. :

Поддерживаются разные модели (включая GPT-серии, Claude и Gemini), а также возможность обращаться сразу к нескольким моделям в рамках одного запуска. Это делает Oracle удобным инструментом для проверки гипотез, ревью кода и сложных расследований. :

Когда использовать

• дебаг и поиск ошибок
• рефакторинг и архитектурные решения
• дизайн-ревью
• кросс-проверка результатов между моделями

Идея проста: вы даёте модели не только вопрос, но и весь нужный контекст — и получаете значительно более точный и практичный ответ.

Как это работает

Oracle формирует «одноразовый» (one-shot) запрос, в который включаются:

• ваш промпт
• файлы проекта (или их подмножество)
• дополнительные параметры (модель, режим и т.д.)

На выходе вы получаете ответ от модели, которая видит реальный контекст вашего кода или проекта, а не абстрактный вопрос.

Основной сценарий (Browser mode)

Наиболее популярный путь — использование браузерного режима с GPT-уровня Pro. В этом случае Oracle автоматически управляет браузером и взаимодействует с ChatGPT без необходимости API-ключей. :

Такой подход предполагает «человека в цикле» (human-in-the-loop): сессия может длиться от нескольких минут до часа, и её можно повторно открыть при необходимости. :

Golden path (рекомендуемый workflow)

• Выберите минимальный набор файлов, содержащих суть проблемы
• Проверьте, что именно будет отправлено (dry-run)
• Запустите задачу в browser mode
• При обрыве — переподключитесь к сессии вместо повторного запуска

Примеры команд

npx -y @steipete/oracle --dry-run summary -p "Check release notes" --file docs/release-notes.md

npx -y @steipete/oracle -p "Cross-check the data layer assumptions" --models gpt-5.1-pro,gemini-3-pro --file "src/**/*.ts"

npx -y @steipete/oracle --engine browser -p "Walk through the UI smoke test"

Ключевые принципы

• Контекст решает всё — чем точнее выбран набор файлов, тем лучше результат
• One-shot подход — модель не помнит прошлые вызовы, каждый запуск автономен
• Результаты — это рекомендации — их нужно проверять на практике

Почему это важно

Обычные запросы к моделям часто страдают от нехватки контекста. Oracle решает эту проблему, превращая взаимодействие с AI в более инженерный процесс: вы явно задаёте входные данные и получаете воспроизводимый результат.

Это особенно полезно в сложных проектах, где детали распределены по множеству файлов и невозможно объяснить всё вручную в одном сообщении.

Итог

Oracle — это инструмент для тех, кто хочет использовать AI не как чат, а как полноценного ассистента разработки. Он помогает моделям «видеть» ваш проект целиком и давать ответы, приближённые к реальной инженерной практике.