Background UI Debug

What it does

When your agent uses it

• Tasks that involve Android development
• Tasks that involve Mobile UI design

Example prompts

• “/background-ui-debug”

Requirements

• A Bash shell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1先确认生产应用没有运行，并检查当前任务不会启动 macosApp。
2. 2用 scripts/start_background_ui_debug.sh 构建并启动离屏调试器。脚本只 exec 调试 kexe，不调用任何窗口 API；启动后的首个 ready 事件必须同时满足 windowHost=false 和 dataMode=isolated。
3. 3发送一行一个 JSON 命令。先用 state 再次确认 windowHost=false、dataMode=isolated 和临时 dataHome，随后 dump，再按语义节点执行 click、input、scroll、back、wait 或 screenshot。
4. 4对每个页面枚举所有可点击节点；逐项操作后检查目标页面、返回路径、异常输出和耗时。破坏性动作只验证到提交前状态。
5. 5发现卡死时保留最后一个命令、动作前后语义树、离屏截图、耗时和 stderr；先定位确定根因，再修改生产代码。
6. 6修改后重跑相同命令序列，随后构建 release，并验证 release 二进制不含协议标记 ZHPP_BACKGROUND_UI_DEBUG_V1。

What it can do on your machine

Read from SKILL.md and the folder at commit 2daa669. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Shell), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • gnu.org

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Background UI Debug loads about 657 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 48 tokens; SKILL.md has 108 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~48

When it runs · the whole SKILL.md, loaded when a task matches

~657

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from zly2006/zhihu-plus-plus at commit 2daa669, republished under its AGPL-3.0 licence (© zly2006). 108 words, ~657 tokens.

name

background-ui-debug

description

在不创建、激活或切换任何前台窗口的前提下，通过项目的 debug-only 离屏 Compose UI 控制接口检查语义树、点击、输入、滚动、等待和截图。适用于 macOS Kotlin/Native UI 回归、页面卡死、导航完成度和逐按钮验收；禁止用 AppleScript、System Events、open、桌面截图或坐标点击替代。

<!--
Zhihu++ - Free & Ad-Free Zhihu client for all platforms.
Copyright (C) 2024-2026, zly2006 <i@zly2006.me>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation (version 3 only).

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
-->

© zly2006, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in .agents/skills/background-ui-debug of zly2006/zhihu-plus-plus.

• SKILL.md
• agents/openai.yaml
• references/protocol.md
• scripts/start_background_ui_debug.sh

Open the folder on GitHubat commit 2daa669