Используйте этот сценарий, когда перед вопросами или изменениями нужна достоверная первичная карта репозитория. CodeGraph определит границы проекта, языки, доступные графовые и документальные свидетельства, важные пробелы и следующие файлы для чтения. Сценарий не пытается объяснить весь репозиторий за один проход.
Быстрый старт
Откройте репозиторий в установленном клиенте OpenCode и выполните:
/onboard
Команда не привязана к языку, системе сборки, структуре каталогов, операционной системе или оболочке.
Что проверяет сценарий
Текущая команда выполняет ограниченную последовательность:
codegraph_project_context_statusпоказывает, пригоден ли контекст проекта.codegraph_project_context_sync_statusсообщает об ожидающей или устаревшей синхронизации.codegraph_context_session_openоткрывает или повторно использует явную контекстную сессию.codegraph://project/contextвозвращает обнаруженные метаданные проекта и языки.codegraph_context_retrieval_evidence_fetchиcodegraph_context_retrieval_fused_searchнаходят свидетельства об архитектуре и документации.codegraph_context_retrieval_file_readчитает только фрагменты исходников, необходимые для проверки утверждения.
codegraph_digital_employee_skill_search может добавить одну ограниченную подсказку для знакомства. Основой ответа остаются свидетельства из исходного кода.
Сначала оцените режим готовности
| Режим | Что он означает | Безопасное следующее действие |
|---|---|---|
ready |
Контекст проекта и необходимые источники свидетельств доступны. | Задавайте точечные вопросы и переходите к адресному чтению исходников. |
sync-pending |
Проекция контекста ещё не догнала рабочую копию. | Зафиксируйте состояние и дождитесь либо запустите документированную синхронизацию. |
graph-only |
Структурный граф доступен, но семантический контекст или память недоступны. | Используйте только ограниченные графовые факты и явно обозначьте отсутствие семантического контекста. |
| Устаревший или заблокированный контекст | Сервер сообщает, что контекст сейчас нельзя считать достоверным или обновить. | Верните предоставленные сервером блокер и следующее действие; не подменяйте их устаревшей поверхностью. |
Каким должен быть результат
После знакомства другой инженер должен понимать:
- какие каталог и границы проекта обнаружил CodeGraph;
- какие языки и крупные подсистемы подтверждены свидетельствами;
- какие стартовые пути или точки входа действительно проверены;
- в каком режиме готовности получен ответ и какие ограничения из этого следуют;
- какие выводы подтверждены исходниками, а какие остаются неизвестными;
- какое минимальное следующее исследование сильнее всего уменьшит неопределённость.
Считайте сгенерированное резюме навигационной подсказкой. Прежде чем переносить утверждение в дизайн, ревью или изменение, откройте указанное свидетельство в текущем исходном коде.
Когда нужно остановиться
Сузьте запрос, если в репозитории несколько продуктов, целевая подсистема неясна или ответ содержит только совпадения по всему графу. Хороший следующий вопрос называет один пользовательский путь, компонент, функцию или область изменения. Знакомство даёт контекст репозитория. Заключение по безопасности, архитектурное одобрение и решение о выпуске оформляются отдельными ответственными процессами и свидетельствами.
Поддерживаемые источники контракта
- Сценарий OpenCode:
.opencode/commands/onboard.md - Маршрутизация ролевых сценариев:
src/digital_employees/runtime/scenarios/role_bound_scenario_invoker.py - Политика сотрудников и сценариев:
src/digital_employees/runtime/scenarios/employee_scenario_invocation.py
После знакомства используйте аудит безопасности для ограниченной проверки или разработку функции, когда область реализации уже согласована.