前言¶
需求文檔寫完後，測試用例往往仍靠人工從 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
