菜单
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 职业分类
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.
| 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.