前言¶
寫系統提示詞或任務提示詞時，常見問題是需求一句話帶過，模型輸出時好時壞，改兩句又牽出一串副作用。自己試幾輪往往停在「感覺對了」，卻沒有固定測試和迭代步驟，上線或交給同事用時仍容易翻車。
下面介紹 SkillHub 上的社區 Skill「提示詞專家」（座標 @user_8d26dabd/qclaw-prompt-engineer）。它面向「提示詞不穩定、預期說不清」這類痛點，把模糊目標整理成更可執行的提示詞，並附帶少量測試用例與迭代思路，便於對齊預期。
這是什麼¶
「提示詞專家」是 SkillHub 分類 ai-agent 下的社區 Skill，當前版本 2.1.4，發佈者爲 user_8d26dabd，SkillHub 頁面標註作者爲劉楠。官方資源地址爲 https://api.skillhub.cn/user_8d26dabd/qclaw-prompt-engineer，頁面入口爲 SkillHub 技能頁。
標籤 requires_api_key=false，表示按 SkillHub 標註無需額外 API Key 即可使用 Skill 本身（具體仍取決於你所用的 Agent 與模型配置）。
一句話定位（摘自官方簡介）：在提示詞經常翻車時，幫你把含糊需求轉成更穩的輸出向提示詞，並附 5–10 條測試用例 與 迭代方法，用於對齊預期。
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述，不展開未在資料中出現的具體模板或內部指令。
-
需求澄清與提示詞整理
將口語化、邊界不清的需求，整理爲更適合大語言模型執行的提示詞表述，減少「同一句話不同天輸出風格迥異」的情況。 -
配套測試用例
爲整理後的提示詞提供約 5–10 條測試用例，用於快速檢查輸出是否覆蓋主要場景與約束，而不是隻靠單次對話主觀判斷。 -
迭代方法論
提供與測試用例配套的迭代思路，便於根據失敗樣例調整提示詞並複測，而不是零散改字句。
SkillHub 側統計（以抓取資料爲準）：評分 100000，下載 2088 次。
安裝與啓用¶
SkillHub 官方安裝說明見 skillhub.md。頁面亦建議：讓 AI 按該文檔安裝 @user_8d26dabd/qclaw-prompt-engineer。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可用官方腳本（完整安裝含默認 Skill；僅需 CLI 時加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄；默認裝到 ./skills/ 可能不會被識別，且部分環境安裝後需重啓 Agent。
skillhub install user_8d26dabd/qclaw-prompt-engineer --dir <你的 skills 目錄>
常用路徑（摘自 SkillHub 安裝文檔，按你實際使用的客戶端選擇其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（Cursor）：
skillhub install user_8d26dabd/qclaw-prompt-engineer --dir ~/.cursor/skills/
搜索技能時也可使用：
skillhub search qclaw-prompt-engineer
資料中未單獨列出 Codex CLI、Claude Code 與本 Skill 的差異配置；除 skills 目錄路徑不同外，安裝命令形式一致。
典型用法¶
官方未在公開頁面粘貼完整 SKILL.md 對話樣例，可復現的用法如下。
- 按上一節將 Skill 安裝到對應
skills目錄，並重啓或重新加載 Agent 的技能列表。 - 在對話中啓用或引用「提示詞專家」Skill（具體觸發方式取決於 Agent 對 Skill 的加載規則）。
- 用自然語言描述當前痛點：例如任務目標、現有提示詞、哪些輸出不符合預期、有哪些硬約束。
- 根據 Skill 簡介，預期產出包括：整理後的提示詞、5–10 條測試用例，以及可執行的迭代步驟；用測試用例逐條跑模型輸出，再按迭代法改提示詞並複測。
若 CLI 未就緒，也可將 SkillHub 頁面上的安裝提示交給 AI：讓其閱讀 https://skillhub.cn/install/skillhub.md 並完成 @user_8d26dabd/qclaw-prompt-engineer 的安裝。
適用場景與注意¶
更適合
- 需要寫系統提示詞、角色設定或複雜任務提示詞，但需求仍偏模糊、難以一次寫穩的開發者或提示詞維護者。
- 希望用少量固定用例做迴歸，而不是每次改詞只靠直覺的團隊。
- 使用 Cursor、Claude Code、Codex 等支持 Skill 目錄的 Agent，並願意通過 SkillHub 管理技能包。
注意
- 本 Skill 給出的是提示詞結構與評測迭代流程，不能替代你對業務合規、數據隱私與模型選型的判斷。
- 測試用例數量官方表述爲 5–10 條，複雜業務仍需你補充邊界樣例與線上監控。
- 版本、下載量等以 SkillHub 頁面爲準；升級可用
skillhub對應更新命令（遵循 skillhub.md 第三節）。 - 社區來源（
community），使用前可在 SkillHub 頁查看版本說明與作者信息，自行評估是否納入工作流。
結尾¶
「提示詞專家」把「含糊需求 → 可執行提示詞 → 小集測試 → 迭代對齊」串成一條可重複的路徑，適合在提示詞經常翻車、又缺少系統化評測時接入 Agent。安裝與座標以 SkillHub 爲準：@user_8d26dabd/qclaw-prompt-engineer，https://www.skillhub.cn/skills/user_8d26dabd/qclaw-prompt-engineer。
