메뉴
Run Textual TUI tests with proper timeouts. Use when running TUI unit tests or after making code changes.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | tui-test |
| description | Run Textual TUI tests with proper timeouts. Use when running TUI unit tests or after making code changes. |
| argument-hint | [smoke|unit|all] |
| allowed-tools | Bash |
Run Textual TUI tests with pytest-xdist parallel execution (2 workers).
/tui-test [smoke|unit|all]
| Option | Description |
|---|---|
| (none) | Run all TUI tests (unit + smoke) |
smoke | Smoke tests only - fast runtime verification |
unit | Unit tests only |
all | Run all tests |
# Smoke tests only (fast verification)
source venv/bin/activate && timeout 60 pytest -m smoke kubeagle/tests/tui/smoke/ -n 2 -v --tb=short --timeout=30
# All tests
source venv/bin/activate && timeout 120 pytest kubeagle/tests/tui/ -n 2 -v --asyncio-mode=auto --timeout=30 --tb=short
# Unit only
source venv/bin/activate && timeout 120 pytest kubeagle/tests/tui/unit/ -n 2 -v --asyncio-mode=auto --timeout=30 --tb=short
| Type | Per-test | Global |
|---|---|---|
| Smoke | 30s | 60s |
| Unit | 30s | 120s |
pkill -f pytest
kubeagle/tests/tui/
├── smoke/
│ ├── keybindings/ # Navigation and table binding tests
│ ├── screens/ # Per-screen smoke tests (charts/, cluster/, detail/, home/, reports/, settings/, teams/)
│ ├── test_custom_data_table_runtime.py # Runtime data table smoke test
│ └── test_keypress_navigation.py # Keypress navigation smoke test
└── unit/
├── controllers/ # Fetchers, parsers, mappers, analyzers
├── constants/ # Defaults, enums, limits, optimizer, patterns, screen, tables, timeouts, ui, values
├── models/ # State, cache, core, events, teams, optimization, reports
├── presenters/ # Screen presenter logic
├── widgets/ # Containers, data tables, display, filter, input, selection, special
├── optimizer/ # Analyzer, fixer, rules
├── config/ # Screen config tests
├── mixins/ # Screen mixin tests
├── utils/ # Resource parser, etc.
├── test_app.py, test_base_screen.py # App and base screen tests
├── test_cache_manager.py, test_concurrent.py # Utils tests at root
├── test_custom_data_table.py, test_footer_widget.py # Widget tests at root
├── test_modularization.py, test_optimizer_unit.py # Structure and optimizer tests
├── test_screen_data_loader.py, test_worker_mixin.py # Mixin tests at root
└── test_*_fix_regression.py # Regression tests for fixes
Smoke tests are infrastructure (maintained by tui-test-engineer, used by tui-developer for quick verification).
For visual/UX verification, use /visual-analysis instead.
Run all code convention checks (constants, enums, keybindings, models, inline CSS). Run after implementation to enforce project standards.
Run lint + typecheck together. Use after implementation, before committing, or when checking code quality.
Textual CLI devtools for running, debugging, and exploring TUI apps. Includes run, console, serve, keys, colors, borders, easing commands. Used by tui-developer, tui-test-engineer, and tui-ux-specialist.
Complete visual analysis workflow - screenshot capture with automatic PNG conversion, AI vision analysis. Use for UX review, freeze detection, and visual verification.
Run all TUI code convention checks (constants, enums, keybindings, models, inline CSS) after implementation to enforce project standards and catch misplaced patterns.
Run lint and type checks together after implementation and before commit to validate code quality for the CLI, TUI, and visual-analysis tooling.