메뉴
Enforce REvoDesign Qt/PyMOL conventions. Use when touching Qt imports, threading, UI loading, PyMOL API calls, or i18n strings. Catch the mistakes that cause SIGABRT or silent breakage across Qt5/Qt6.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Review a diff against the goal spec assuming the code is BROKEN. The reviewer that lives in the maker's head always agrees with itself — this pulls review into a hostile, separate pass. Invoke after every code change before marking work done.
Verify that an endpoint checks ownership, not just authentication. Use on any handler that reads or mutates user data.
Find the exact commit that introduced a bug. Use when something worked before and broke, and you don't know which change did it.
Turn a set of commits or a diff into a clean, user-facing changelog entry. Use before a release or PR description.
Turn messy WIP into clean, atomic commits with messages that explain why. Use before opening a PR.
Keep the agent's context lean so accuracy doesn't collapse. Use on long sessions, big files, or when the agent starts hallucinating.
| name | qt-pymol-guardrails |
| description | Enforce REvoDesign Qt/PyMOL conventions. Use when touching Qt imports, threading, UI loading, PyMOL API calls, or i18n strings. Catch the mistakes that cause SIGABRT or silent breakage across Qt5/Qt6. |
| when_to_use | Qt widget code, PyMOL cmd usage, thread spawning, .ui file changes, translation strings, RuntimeUiProxy usage |
NEVER import PyQt5, PyQt6, or PySide directly in runtime code. Every Qt import goes through REvoDesign.Qt:
from REvoDesign.Qt import QtCore, QtWidgets, QtGui
The pre-commit hook check_qt_binding_imports.py enforces this. At TYPE_CHECKING time the wrapper imports from PyQt5 for static analysis; at runtime it resolves through pymol.Qt.
qexec(dialog) not dialog.exec() or dialog.exec_(). From REvoDesign.Qt.qt_wrapper.QtCompat.AlignCenter (from qt_wrapper) rather than QtCore.Qt.AlignCenter._qt_enum(owner, enum_name, member_name) when writing compatibility-sensitive code.QT_BACKEND and QT_MAJOR are set at import time. Don't branch on them unless you have to.Long-lived event-loop servers (uvicorn, asyncio) MUST use threading.Thread, never QThread.
This is not pedantry — QThread creates a SIP-managed C++ object whose Python wrapper can outlive the C++ object during GC. When cross-thread Qt signals touch the stale wrapper → sipWrapper_dealloc → forgetObject → QMessageLogger::fatal → SIGABRT. Heisenbug: moves every time you change code.
threading.Thread: uvicorn servers, asyncio event loops, long-lived background work not coupled to Qt widgets. Pattern: _run_server_and_mark_stopped wraps server.run() in try/finally clearing is_running.WorkerThread (QThread): short-lived Qt-adjacent jobs where signals/slots are needed. Created via run_worker_thread_in_pool(fn, trigger_buttons=..., notify_slot=...).threading.Thread from main thread: pump Qt events with QApplication.processEvents() so UI doesn't freeze.threading.Thread with MagicMock(is_alive.return_value=False), no spec=WorkerThread.load_runtime_ui(ui_path) returns (window, RuntimeUiProxy). Never compile .ui to Python modules.apply_ui_to_widget(ui_path, widget).RuntimeUiProxy exposes them as attributes via refresh_bindings() (walks findChildren, uses objectName()). Never findChild() directly._duplicate_object_names, only first-seen becomes attribute.python dev/tools/generate_ui_typing.py. Pre-commit hook enforces freshness. REvoDesignUiProtocol in types.py is for static analysis only — it never constructs the UI.Ui_REvoDesign.py is deprecated and blocked by reject_generated_main_ui.py pre-commit hook.Import convention: from pymol import cmd (never import pymol; pymol.cmd.xxx).
Common operations: cmd.get("session_file"), cmd.save(filename), cmd.load(filepath), cmd.reinitialize(), cmd.remove(selection), cmd.alter(selection, expr), cmd.select(name, expr), cmd.get_names(type=..., enabled_only=...), cmd.get_model(selection), cmd.get_chains(selection), cmd.get_coords(selection), cmd.centerofmass(selection).
Session reset pattern: save to temp → cmd.reinitialize() → cmd.load(temp) → cmd.remove('not alt ""+A') → cmd.alter("all", 'alt=""').
Other imports: from pymol import cgo, from pymol.vfont import plain, from pymol.parsing import QuietException, from pymol.plugins import addmenuitemqt, import pymol2 (for sub-interpreters).
_translate = QtCore.QCoreApplication.translate then _translate("Context", "string").src/REvoDesign/UI/language/language.json — entries with code, name, action. .qm files alongside.install_translator_early() before splash (reads from YAML directly), then LanguageSwitch after window creation.RuntimeUiProxy.retranslateUi() dispatches to generated retranslateUi or sends LanguageChange event.LanguageSwitch._retranslate_language_actions() handles menu action texts (not covered by .ui retranslation)..qm file + JSON entry. English (eng-eng) has no .qm — source strings are the fallback.REvoDesignException in src/REvoDesign/issues/exceptions.py.REvoDesignWarning in src/REvoDesign/issues/warnings.py.warnings.warn(issues.SomeWarning("message")).notify_box(message, error_type, details) shows QMessageBox from any thread (marshals to GUI thread).ROOT_LOGGER.getChild(__name__) for module-level, ROOT_LOGGER.getChild(self.__class__.__name__) for class-level. JSON-structured via REvoDesignLogFormatter.