前言¶
需求文档写完后，测试用例往往仍靠人工从 PRD、用户故事或接口说明里逐条拆场景。覆盖容易漏维度，边界和异常路径也难统一口径；已有用例库要评审、补洞时，同样费时。下面介绍 SkillHub 上的社区 Skill「功能用例编写」，把「从输入材料到可执行用例」的工作交给 Agent，并在官方描述中强调黑盒方法与多测试维度，适合需要结构化用例而不是零散提示词的团队。
这是什么¶
「功能用例编写」是 SkillHub 坐标 @user_ab1ce028/functional-use-cases 上的 Agent Skill（版本 1.0.1，分类 dev-programming，来源 community，发布者 user_ab1ce028）。它面向「基于需求文档或现有测试用例进行设计、评审、优化」这一类任务：分析用户提供的 PRD、用户故事、API 文档或既有用例，生成或完善测试用例，并覆盖功能、性能、安全、易用性、界面、兼容性、异常场景等维度；方法上采用边界值分析、等价类划分、决策表等黑盒手段。标签标明 requires_api_key=false，不依赖额外 API Key。
官方页面：https://www.skillhub.cn/skills/user_ab1ce028/functional-use-cases
API 入口：https://api.skillhub.cn/user_ab1ce028/functional-use-cases
核心功能¶
依据 SkillHub 页面与已抓取资料，可核实的能力包括：
- 从需求材料编写用例：接受 PRD、用户故事、API 文档等输入，输出更全面、可追踪的测试用例。
- 评审与优化既有用例：对现有用例做评审、纠错、补充覆盖，或按维度查漏补缺。
- 测试计划相关辅助：在官方描述中包括制定测试计划、修正用例错误、补充测试覆盖等使用场景。
- 多维度与黑盒方法：除功能外，明确覆盖性能、安全、易用性、界面、兼容性、异常场景；并应用边界值、等价类、决策表等。
- 游戏测试侧重（官方说明）：页面特别举例米哈游系产品场景，如玩法、平衡性、角色技能、道具、多人联机、付费系统等——属于技能自述的适用延伸，使用时仍以你方真实需求为准。
安装与启用¶
安装流程遵循 SkillHub 通用说明（https://skillhub.cn/install/skillhub.md）。先做环境检查，再安装技能到当前 Agent 的 skills 目录；未指定 --dir 时默认装到 ./skills/，多数客户端不会自动加载，需自行对准路径。
1、检查 SkillHub CLI
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
将 @user_ab1ce028/functional-use-cases 安装到当前环境的 skills 目录。官方安装页给出的提示为：根据 https://skillhub.cn/install/skillhub.md 安装该坐标。命令形态如下（<skills 目录> 按客户端替换）：
skillhub install @user_ab1ce028/functional-use-cases --dir <skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端规则刷新或重启，使 Skill 被识别。公开资料未单独列出 Cursor 与 Codex 的差异步骤，差异主要体现在 --dir 指向的目录。
典型用法¶
官方未提供固定对话脚本，但明确了可复现的任务类型。在 Agent 中启用该 Skill 后，可按下面方式组织输入（示例为任务描述，非官方逐字示例）：
基于需求文档写用例
向 Agent 附上 PRD 片段或用户故事，并说明期望输出格式（例如：用例编号、前置条件、步骤、预期结果、优先级）。Skill 自述会按多维度与黑盒方法展开场景。
评审与优化现有用例
粘贴当前用例表或测试管理工具导出内容，要求指出遗漏维度、边界与异常路径，并给出修订或增补条目。
补充覆盖或测试计划
在已有用例集上声明目标（如「补齐安全与兼容性」「为某 API 补异常类用例」），让 Agent 对照需求或接口说明做差距分析。
游戏向需求若与官方举例一致，可在提示中写明模块（玩法、付费、联机等），仍建议附带真实设计说明，避免仅依赖泛化场景名。
适用场景与注意¶
适合谁
- 测试、QA 与开发自测：需要快速从文档落到结构化用例，或统一评审口径。
- 接口与业务功能验收：输入 API 文档或 PRD 即可触发多维度拆分。
- 用例债较多的项目：评审、纠错、补覆盖、整理测试计划等，官方均列为使用场景。
使用注意
- 社区来源（
community），质量与更新节奏依赖发布者；安装前可在 SkillHub 查看版本（当前页面为 v1.0.1）与说明是否匹配你的流程。 - 页面统计（以已抓取资料为准）：评分 100000，下载 4675，安装 100——仅作商店热度参考，不代表你方项目效果。
- Agent 输出仍需人工做业务确认与优先级裁定，尤其是安全、付费、联机等高风险域。
- 无需 API Key，但安装 CLI 与
skillhub install需要网络；沙箱环境需放行相应权限。
结尾¶
「功能用例编写」把测试用例的设计、评审与优化收敛成可重复的 Skill 工作流，并写明多维度覆盖与黑盒方法，减少从文档到用例表的重复劳动。若你正在 SkillHub 上选型测试类 Skill，可从官方页查看说明并安装 @user_ab1ce028/functional-use-cases：
https://www.skillhub.cn/skills/user_ab1ce028/functional-use-cases
