메뉴
以 subagent 启动的 UI 漫游与异常发现技能。Use when the user, AGENTS, or the current task requires “UI漫游者”. 该 skill 负责系统性地把目标页面能点的都点一遍、把上下左右能滑的都滑一遍，重点发现空白页、越界、裁切、错位、布局失衡、状态切换异常等问题；必要时结合 ui-test 与截图检查，并把意见记入 .memory/YYYY-MM-DD/ui-volayor。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Release the LaTeX fork used by Zhihu++. Use when merging the latest huarangmeng/latex release into zly2006/latex, preserving approved fork deltas, publishing Maven Central artifacts, updating Zhihu's vendored third_party/markdown and direct LaTeX dependencies, and verifying the app.
Build, install, and launch the Zhihu++ Android app on a connected device using ADB. Includes comprehensive troubleshooting for common issues like missing devices, installation failures, signature mismatches, and app crashes. Use when deploying debug builds to physical devices or emulators.
Manage screenshots and other visual assets for GitHub pull requests. Use when a PR body needs real screenshots, when local /tmp paths must be replaced with durable links, when deciding whether GitHub web drag-and-drop uploads can be reproduced with gh api, or when updating a PR without disturbing the user's browser tabs.
Use for Zhihu++ maintenance work that scans Kotlin main sources for low-call functions, structurally similar function bodies, dead code, pure forwarding wrappers, pointless abstractions, repeated helpers, and cross-platform duplicate glue before refactoring or PR cleanup. Trigger when the user asks to clean AI slop, remove low-call wrappers, find similar or duplicated code, review duplicated helper functions, or audit functions with call count at most 2 in /Users/zhaoliyan/IdeaProjects/Zhihu.
Coordinate Zhihu++ issue and PR implementation through subagents with isolated git worktrees, off-host Android AVD validation, real screenshots, Chinese PR creation, and main-agent-only review/coordination. Use when the user asks to fan out issues, maximize parallel subagent work, implement multiple Zhihu++ features or fixes, validate on `$off-android-avd-ci-debug`, or automatically open PRs from worker branches.
Zhihu++ LLM 自动化 UI 测试。使用 testTag 系统精准定位 Compose 元素并交互，替代硬编码坐标的 adb tap。提供已知 tag 列表、文字内容点击、截图验证等能力。适用于：功能验证、UI 回归测试、自动化交互流程。
| name | ui-voyager |
| description | 以 subagent 启动的 UI 漫游与异常发现技能。Use when the user, AGENTS, or the current task requires “UI漫游者”. 该 skill 负责系统性地把目标页面能点的都点一遍、把上下左右能滑的都滑一遍，重点发现空白页、越界、裁切、错位、布局失衡、状态切换异常等问题；必要时结合 ui-test 与截图检查，并把意见记入 .memory/YYYY-MM-DD/ui-volayor。 |
| license | CC BY-NC-SA 4.0 |
spawn_agent(agent_type="verifier")；若更偏 UI 行为探索，可用 critic 作为备选。TODAY=$(date +%F)
python3 .agents/skills/ui-review-memory/memory_store.py show-pending --agent ui-volayor --date "$TODAY"
ui-volayor 作为 memory key，这是项目约定路径。show-pending 会跨天读取所有未关闭意见，不只看今天的目录。fixed / rejected / invalid 且有理由地关闭，必须重新提出。dump 当前页面。dump 或截图验证。优先使用：
python3 .agents/skills/ui-test/llm_test_helper.py dump
python3 .agents/skills/ui-test/llm_test_helper.py tap --tag ...
python3 .agents/skills/ui-test/llm_test_helper.py screenshot /tmp/ui-voyager.png
只有在没有 tag / text / desc 且必须手势时，才使用 adb shell input swipe ...。
如果你怀疑某个点不一定是 bug，而更像产品/UI 判断题：
picky-user 从用户视角再判断一次。TODAY=$(date +%F)
python3 .agents/skills/ui-review-memory/memory_store.py record-issue \
--agent ui-volayor \
--date "$TODAY" \
--persona explorer \
--severity high \
--kind rendering \
--title "横向卡片滚动后右侧内容被截断" \
--why "滚动结束后最后一张卡片右边界不可见，属于明确渲染异常。" \
--repro "进入目标页，向左滑动横向卡片列表直到最后一项。" \
--expected "每张卡片都应完整显示，边距一致。"
kind 推荐值：rendering、layout、navigation、state、blank、other如果你确认一个已关闭问题再次出现，使用 --reopen 复用旧 id：
TODAY=$(date +%F)
python3 .agents/skills/ui-review-memory/memory_store.py record-issue \
--agent ui-volayor \
--date "$TODAY" \
--persona explorer \
--severity high \
--kind rendering \
--title "已关闭的渲染异常再次出现" \
--why "相同渲染问题重新复现，应该沿用旧编号。" \
--repro "按原路径进入页面并重复相同步骤。" \
--expected "复用旧 issue id 并标记为 reopened。" \
--reopen
Status: pass | needs-work
Coverage:
- 点击过的入口：...
- 访问过的状态：...
- 执行过的滑动：up/down/left/right
Confirmed bugs:
1. [high] 标题
Repro: ...
Why bug: ...
Memory: UV-20260417-001
Needs picky-user judgement:
1. 标题
Repro: ...
Why unsure: ...
Carry-over:
- UV-20260417-00X: ...
TODAY=$(date +%F)
python3 .agents/skills/ui-review-memory/memory_store.py update-status \
--agent ui-volayor \
--date "$TODAY" \
--id UV-20260417-001 \
--status rejected \
--note "设计确认后判定这是有意保留的滚动裁切，不视为 bug。"
update-status 会按 id 自动定位旧记录，所以即使 issue 来自前几天，也可以继续传今天的 --date。