AIKraft/AI/Войти
AIKraft/Skills/cmux-debugging

cmux-debugging

Отладочное логирование, меню отладки и локальная визуальная итерация для cmux. Полезно при добавлении зондов отладки, диагностике проблем UI/runtime, работе с терминалом, списками SwiftUI, drag/drop UTTypes и использованием Debug menu.

MAmanaflow-ai official Разработка ★ 27.6k

Что делает навык

Навык обеспечивает отладочное логирование, меню отладки и локальную визуальную итерацию для приложения cmux. Он позволяет добавлять зонды отладки, диагностировать проблемы UI/runtime, работать с терминалом, списками SwiftUI, drag/drop UTTypes и использовать Debug menu.

Когда применять

  • Добавление зондов отладки для отслеживания событий клавиатуры, мыши, фокуса и вкладок.
  • Диагностика проблем пользовательского интерфейса и времени выполнения (runtime) в macOS-приложении.
  • Отладка взаимодействия с терминалом, списками SwiftUI и drag/drop UTTypes.
  • Использование Debug menu для локальной визуальной итерации и мониторинга состояния приложения.

Как работает

  1. Использовать команду tail -f для мониторинга файла журнала отладки, путь к которому определяется через /tmp/cmux-last-debug-log-path или /tmp/cmux-debug.log.
  2. Обернуть все вызовы логирования (например, cmuxDebugLog) в директивы #if DEBUG / #endif, так как реализация находится в пакетах CMUXDebugLog и DebugLogging.swift.
  3. Добавлять instrumentation для событий (keys, mouse, focus, splits, tabs) в соответствующие файлы, такие как AppDelegate.swift или inline в views (ContentView, BrowserPanelView).
  4. Использовать стабильные префиксы событий (focus.panel, tab.select, pane.drop и др.) для структурирования логов.
  5. Применять скрипт reload.sh с флагом --tag для создания именованных логов в /tmp/cmux-debug-<tag>.log и настройки CLI-путей.

Примеры запросов агенту

Добавь логирование события выбора вкладки, используя стабильный префикс tab.select.
Отслеживай события мыши и фокуса в ContentView, обернув вызовы в #if DEBUG.
Запусти мониторинг отладочного лога cmux через tail -f, используя путь из /tmp/cmux-last-debug-log-path.

Что понадобится

  • Среда сборки DEBUG (так как весь код обернут в #if DEBUG).
  • Наличие скрипта reload.sh и файлов в Packages/macOS/CMUXDebugLog и Sources/App.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «cmux-debugging» из репозитория: # https://github.com/manaflow-ai/cmux
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r cmux-debugging/ ~/.claude/skills/cmux-debugging/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.