前言¶
手工从设计稿或原型图拆测试用例，往往要反复对照截图：有哪些控件、默认值和提示语是什么、弹窗和跳转怎么测。设计迭代快时，用例还容易漏项或和界面脱节。下面介绍一个在 SkillHub 上发布的社区 Skill，把「看图写用例」收敛成固定流程：你上传 UI 图，Agent 按 SKILL 里的规则识别元素并生成用例，减少重复口述需求。
这是什么¶
通过 UI 图生成测试用例（坐标 @user_c3b299c0/qkym，版本 1.0.0）是 SkillHub 社区来源（community）的 Agent Skill，分类为 dev-programming，由发布者 user_c3b299c0 维护。
Skill 内定位是：上传 UI 设计图、原型图或页面截图后，自动解析页面元素、布局、交互、文案、弹窗、按钮等，输出结构化的思维脑图式测试用例，无需你再逐条补充界面描述。SkillHub 页面标注 requires_api_key=false，不依赖额外 API Key 配置。
核心功能¶
依据 Skill 包内 SKILL.md，Agent 在启用该 Skill 后应遵守以下能力边界（均为 Skill 正文约定，非第三方案例）：
-
识图与元素枚举
根据你上传的 UI 图片，识别页面名称、顶部导航、输入框、下拉框、单选/复选、按钮、弹窗、图标、文案、分页、跳转入口，以及状态置灰、默认值、提示语等可见信息。 -
按模块拆功能点
自动拆分功能点并按模块归类；例如「添加弹窗」内各可填字段可单独成条，便于查阅。 -
覆盖维度
用例需覆盖：正常场景、边界值、异常输入、空值、特殊字符、按钮状态、弹窗关闭/确认、页面跳转、文案显示、兼容性视觉等。 -
输出形态
可先输出思维脑图形式的测试点，再生成更详细、可执行的思维脑图测试用例；用例标题简洁，步骤按 1、2、3 编号；重要级别分为高/中/低。 -
多页与触发方式
若一张图或多张图对应多页面，分页分别生成；Skill 约定触发口令为：上传图片后按上述整套规则执行，无需额外提问或补充需求（除非你在对话中另有说明）。
安装与启用¶
官方页面给出的安装指引是：先阅读 SkillHub 安装与优先源配置，再安装坐标 @user_c3b299c0/qkym。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
未安装时，可按安装文档执行完整安装（示例为文档中的推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被 Agent 加载。
skillhub install @user_c3b299c0/qkym --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（Cursor）：
skillhub install @user_c3b299c0/qkym --dir ~/.cursor/skills/
安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录位置；安装命令本身一致，差异仅在 --dir 目标路径。
典型用法¶
经过上面的步骤启用 Skill 后，可按 Skill 内「触发口令」使用：
- 在对话中上传一张或多张 UI 设计图、原型图或页面截图（多页面时 Skill 要求分页分别生成）。
- 说明需要生成测试用例（或直接使用 Skill 约定的「上传图片即按规则执行」方式）。
- 查看 Agent 输出：先出现的思维脑图式测试点，以及后续的详细、可执行用例；检查模块拆分与优先级（高/中/低）是否符合你的项目规范。
Skill 正文要求 Agent 不废话、不闲聊，聚焦用例内容；你若对某模块需要加强边界或异常场景，可在同一会话中追加约束，但 Skill 默认目标是「看图直接全套生成」。
适用场景与注意¶
适合谁
- 前端或全栈同学在需求/设计稿阶段需要快速铺测试点清单。
- QA 需要把界面截图转成可评审的结构化用例，减少从图到表格的机械抄写。
- 多页面原型需要按页拆分、避免漏测可见控件和弹窗交互。
限制与注意
- 输出质量依赖 Agent 对图片的识别能力及你是否提供了清晰、完整的界面图；Skill 未承诺对接具体测试管理工具或固定 Excel/JSON 模板，落地到你们公司的用例库仍需人工校对。
- 社区 Skill（
community），维护节奏以发布者为准；使用前可在 SkillHub 页面查看版本与下载情况。截至资料抓取：评分100000，下载1367次（页面统计，会随时间变化）。 - 涉及合规或敏感界面时，注意图片是否适合上传至你所用的 AI 客户端环境。
结尾¶
通过 UI 图生成测试用例把「识图 → 拆模块 → 按维度写用例 → 脑图式输出」写进 Agent 的永久规则，适合想把 UI 验收前测试设计前置到对话里的团队。官方 SkillHub 页面：https://www.skillhub.cn/skills/user_c3b299c0/qkym；API 入口：https://api.skillhub.cn/user_c3b299c0/qkym。
