Menu
Use when modifying TUI layouts, visual alignment, panel grouping, responsive designs, or when same view gets repeated patch commits
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
在 Docker 容器内测试 peeka CLI 和 TUI。用于验证功能在真实容器环境中的端到端工作。触发词："test in container", "verify in docker", "container test", "run e2e", "test CLI then TUI"。
Create a versioned release for peeka. Triggers: /release, version bump, publish to PyPI, create tag, github release, semver. Usage: /release <version|patch|minor|major>
为 peeka E2E 测试构建 Docker 测试镜像。支持构建 gdb（Python 3.8/3.12）和 py314（Python 3.14 PEP 768）镜像。使用 --network=host 处理 fake-ip/tun 模式的网络代理问题。如果镜像已在本地存在则自动跳过构建。触发词："build docker", "create docker image", "docker-build", "build container image", "rebuild test images", "docker-build py38", "docker-build python3.8"。
Analyze fix commits between a git tag and HEAD, review existing postmortem topics, select representative incidents, and generate curated postmortem reports in ./postmortem/. Triggers: postmortem, generate postmortem, incident report, post-mortem analysis, RCA, root cause analysis, analyze fixes, what broke since release, /postmortem <tag>
指导智能体在 Omarchy/Hyprland 上使用 tmux 控制的 Peeka 会话和全局 omarchy-headless-screenshot skill 截取 Peeka TUI 截图。用于记录或验证 Peeka TUI 画面、在目标 workspace 打开或复用 Terminal、启动 `peeka`、导航 Peeka TUI 视图、填写输入框和操作按钮，并在不打扰用户当前可见 workspace 的情况下进行视觉验证。
Runtime Python diagnostics using peeka-cli. Use when debugging Python processes, diagnosing slow performance, finding memory leaks, tracing function calls, watching variables at runtime, analyzing thread issues, or any runtime Python debugging task. Triggers: debug python, diagnose python, slow app, memory leak, trace function, watch expression, runtime debugging, peeka, profile python, thread deadlock, function not called, high CPU python
| name | tui-ux-guardrails |
| description | Use when modifying TUI layouts, visual alignment, panel grouping, responsive designs, or when same view gets repeated patch commits |
防返工技能：TUI 布局/视觉/交互可达性变更的纪律约束。目标是减少"多次小修补"的迭代噪音，提升一次性正确率。
Core principle: 冻结设计意图 → 分层实现 → 几何断言验证。
Trigger when user mentions:
When NOT to use:
| Step | Action | Verification |
|---|---|---|
| 1 | 冻结设计意图 | 3-6 条可验证约束 |
| 2 | 拆分任务 | 先结构，后皮肤 |
| 3 | 最小实现 | 明确"保持不变"清单 |
| 4 | 几何测试 | 宽窄屏各至少 1 条 region 断言 |
| 5 | 验证运行 | ruff + layout tests |
先写后改。输出 3-6 条可验证约束：
- 几何：80 列下双行，140 列下单行
- 结构：Stats 与 Tree 必须是两个独立 panel
- 对齐：A 区块左对齐，B 区块右对齐
- 交互：可通过 Tab 到达
禁止： 未冻结意图前直接改 TCSS。
| 层 | 内容 |
|---|---|
| 结构层 | compose() 树、容器关系、focus 链 |
| 皮肤层 | TCSS（边框、间距、颜色） |
顺序固定：先结构，后皮肤。禁止在一个提交中交替改二者。
digraph test_strategy {
rankdir=LR;
"class 断言" -> "region 几何断言" -> "宽窄屏各一个";
"焦点变更" -> "Tab 可达测试";
}
80x24、140x24tab 焦点链uv run ruff check <changed files>
uv run pytest tests/tui/test_style_layout.py -k "<affected views>" -v
- 设计意图：
- [3-6 条可验证约束]
- 代码改动：
- [结构层变更 + 皮肤层变更]
- 测试证据：
- [几何断言输出 + 焦点测试]
- 非目标范围（保持不变）：
- [明确列出未改动行为]
涉及 UI/UX 的任务在满足以下条件前不得声明完成：
| Excuse | Reality |
|---|---|
| "这只是个小调整" | 小调整累积成视觉不一致。先写设计意图。 |
| "我看截图确认过了" | 主观判断不可靠。几何断言才是可复现的验证。 |
| "顺便改一下旁边的" | 跨视图顺手重构 = 范围蔓延 = 返工根源。 |
| "测试太麻烦了" | 5 分钟写测试节省 30 分钟来回改。 |
| "先提交后面再补" | "后面"永远不会来。 |
All of these mean: Stop. Write design intent first. Then redo in separate commits.
❌ 只改颜色不改结构，却试图解决结构问题 ❌ 只看截图主观判断，不补几何断言 ❌ 在主问题未闭环前顺手改其他视图 ❌ 连续提交多个"fix ui small issue"而不归并
See AGENTS.md → TUI UI/UX 变更守则 for full project-specific requirements.