一句话

给交互式 CLI/TUI 搭一个本地可重复的驱动环境，用确定性输入复现 bug、验证键盘流程、录制前后对照的终端 transcript。

何时用

• 适合：CLI/TUI 的 UX 检查、启动回归、内存增长、挂起、prompt 流程验证；需要给 ctk-verify-this 提供终端 transcript 证据。
• 不适合：纯 UI 验证（用 ctk-control-ui）；仓库已有现成 e2e 能覆盖的场景不必新搭。

怎么用

复现这个 CLI 在 Ctrl-C 后卡死的问题，给我前后两段 transcript

1. 确定被测命令和最小可复现工作区。
2. 先找仓库自带的 harness：package scripts、e2e、demo 录制器、expect 脚本、PTY helper。
3. 没有就用 tmux（capture-pane / send-keys）或临时 Python PTY 脚本起隔离会话。
4. 一次发一个动作，等具体屏幕特征出现再发下一个；存 transcript 和 profile 产物后干净地杀掉会话。

产出

• 可复现的终端 transcript、前后对照证据，需要时的 CPU profile、heap snapshot 或 asciinema 风格录屏。

要点与坑

• Node CLI 可加 NODE_OPTIONS="--inspect=127.0.0.1:0" 接 inspector 做 CPU/heap 分析。
• 硬规则：优先确定性等待不用 sleep；不向受控会话发凭证或破坏性命令；harness 放 /tmp；不硬编码别的仓库的路径；用完清理会话和临时文件。
• pstack 的 pstack-poteto-mode 把本技能列为依赖之一。

关联

• 同类：ctk-control-ui · 下游：ctk-verify-this
• 所属：00-ctk-概览