메뉴
Use when modifying TUI layouts, visual alignment, panel grouping, responsive designs, or when same view gets repeated patch commits
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
在 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.