菜单
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.