前言¶
写系统提示词或任务提示词时,常见问题是需求一句话带过,模型输出时好时坏,改两句又牵出一串副作用。自己试几轮往往停在「感觉对了」,却没有固定测试和迭代步骤,上线或交给同事用时仍容易翻车。
下面介绍 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。