前言¶
功能测试往往卡在「需求读完、用例还没铺开」：PRD、用户故事、接口说明散落在文档和截图里，手工拆场景、补边界和异常路径耗时长，还容易漏项。若只在对话里让模型「随便列几条用例」，输出格式也不统一，后续导入用例库或评审都要再整理一遍。
下面介绍 SkillHub 上的社区 Skill「生成功能测试用例」（@user_23548b01/test-case-generator01）。它面向 Agent 工作流：你把需求文档、图片或文字描述交给已启用该 Skill 的助手，由 Skill 内的指令约束生成结构化、可落地的功能测试用例，减轻从材料到用例表的重复劳动。
这是什么¶
「生成功能测试用例」是 SkillHub 分类 dev-programming 下的社区来源（community）Skill，当前版本 1.0.1，坐标 @user_23548b01/test-case-generator01，发布者为 user_23548b01（SkillHub 页面展示作者为向阳rs）。页面简介写明：可以上传需求文档、图片、文字描述，用于在对话中驱动测试用例设计。
Skill 标签 requires_api_key=false，表示按 SkillHub 标注无需额外配置 API Key 即可使用 Skill 本身（具体仍取决于你所用的 Agent 与模型账号）。
核心功能¶
结合 SkillHub 页面与抓取元数据，目前可核实的能力如下：
- 多形态输入：支持需求文档、图片、文字描述作为测试设计的输入材料。
- Agent Skill 形态：遵循通用
SKILL.md约定，安装到对应 Agent 的 skills 目录后，由模型在匹配任务时加载 Skill 中的流程与输出要求。 - 面向功能测试产出：Skill 名称与分类表明其用途是生成功能向测试用例，而非单元测试代码或自动化脚本生成（页面未声明其他能力时，不宜自行扩展描述）。
页面未公开完整 SKILL.md 正文时，用例字段、是否默认导出 Excel 等细节以安装后的 Skill 文件为准；写作与评审时以实际安装包内容核对即可。
安装与启用¶
官方页面给出的安装方式是：让 AI 参照 SkillHub 安装文档，安装坐标 @user_23548b01/test-case-generator01。文档地址为 https://skillhub.cn/install/skillhub.md。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub 命令：
command -v skillhub && skillhub --version
若未安装，可按安装文档执行完整安装（CLI + 默认 Skill）：
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 指向当前 Agent 识别的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install @user_23548b01/test-case-generator01 --dir <你的 Agent skills 目录>
常见路径（来自官方安装文档，按你实际使用的客户端选择）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按各客户端说明重启或刷新 Agent，使 Skill 生效。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录位置与是否需重启会话；安装命令本身一致，均为 skillhub install 加 --dir。
也可将下面提示词发给已具备 SkillHub 安装能力的 AI，由其按文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_23548b01/test-case-generator01`。
典型用法¶
在 Skill 已安装并加载的前提下，可按「先给材料，再明确测试设计诉求」的顺序使用：
- 在对话中附上需求文档、界面截图或文字版用户故事 / 验收标准。
- 说明需要覆盖的功能范围（例如某一模块、某一接口或某一用户旅程）。
- 要求按功能测试视角输出用例（步骤、预期结果、前置条件等），并说明是否需要表格或文件形式，以便与团队用例模板对齐。
示例提示（材料需替换为你的真实需求）：
我已启用「生成功能测试用例」Skill。附件是登录模块 PRD 与一张错误提示截图。
请根据文档和截图，列出功能测试用例，覆盖正常登录、错误密码、空字段等场景，输出为便于评审的表格。
具体列名、是否生成 Excel、是否强制等价类/边界值等写法，以 Skill 包内 SKILL.md 的约束为准；若输出与团队模板不一致，可在同一会话中要求按指定列名重排。
适用场景与注意¶
适合谁
- 需要在迭代早期快速从 PRD、故事卡、截图整理功能测试用例的开发者或测试人员。
- 已使用 Cursor、Claude Code、Codex 等支持 skills 目录的 Agent，并愿意用 SkillHub CLI 管理 Skill 的团队。
使用上需注意
- 社区 Skill，维护节奏与发布者
user_23548b01相关；升级可用skillhub的更新能力（参见安装文档第三节），安装前留意来源与版本 1.0.1。 - SkillHub 抓取元数据显示：评分 100000，下载 880，
requires_api_key=false；页面统计会变动，引用时以 SkillHub 实时页面为准。 - 模型仍可能漏场景或误解需求，生成结果应经人工评审后再纳入正式用例库；涉密文档勿上传到不可信环境。
- 未在官方页面声明的能力（例如特定测试设计方法的强制清单、固定 Excel 模板字段）不要默认其一定存在，以安装后的 Skill 文件为准。
结尾¶
「生成功能测试用例」把「需求文档、图片、文字描述 → 结构化功能测试用例」收拢到一条 Agent Skill 链路里，配合 SkillHub 安装方式，便于在 Cursor 等客户端复用。如需查看简介、版本与安装提示，可打开 SkillHub 页面：
