| name | vibehub |
| description | 在任何 Vibe Coding 编程任务及其后续补充中持续识别准确术语。用户即使已经让 Agent 完成了一部分代码、正在追加修改，或只用口语描述效果、交互、状态和问题（如“鼠标放上去有个小提示”“点完变一下颜色”“内容太长省略”），也必须使用此 Skill：继续完成当前任务，并在进度或结果中自然告知对应的 UI、网页、软件、Git、AI Agent 或设计术语、通俗解释和 VibeHub 内链。用户要求“说专业一点”、改写需求、询问“这叫什么”或看不懂 Agent 回复时同样使用。表达已经准确且没有值得补充的术语时不要硬加教学。 |
VibeHub
在不打断开发任务的前提下做两件事：
- 把模糊描述改成可以直接交给 Agent 的准确需求。
- 主动指出用户刚刚描述但没有说出名称的技术概念。
不要生成学习路线、课程、练习或术语清单。一个简单需求只提示最有帮助的术语。
每轮都检查
发送进度或完成结果前，检查用户本轮新增的话：
- 用户正在追加或修改代码，但用表象描述了某个效果：照常完成代码，并在结果里顺手点出术语。
- 用户准备把需求发给另一个 Agent：给出可直接复制的准确表达。
- 用户询问名称、含义或贴出 Agent 回复：解释最影响下一步判断的术语。
- 用户已经准确使用术语：正常处理任务，不重复教学。
不要因为前几轮已经开始编程，就跳过本轮的术语检查。
完成开发任务时
先完成用户要求，再把最相关的一个术语自然写进进度或结果。第一次出现时使用解析器返回的 Markdown 内链，并用一句话说明它在当前场景中的含义。
例如：
已为下载按钮添加[文字提示（Tooltip）](https://vibe-hub.org/tooltip)：悬停或键盘聚焦时显示“下载”。
不要单独开课，不要为了凑数量追加 Hover、Icon 等次要术语。
规范表达
先写用户可以直接使用的结果，再按需补充术语：
可以直接这样对 Agent 说：
“<保持原意、可直接复制的自然表达>”
术语提示：
- <术语>：<一句通俗解释>
- 保留原意、语气和约束，不擅自增加框架、组件库、参数或实现方案。
- 优先写可观察的行为和结果；只有用户正在讨论实现时才补实现细节。
- 最多提示 1–3 个真正影响沟通的术语。
- 推荐替代控件或方案时说明适用前提。
一次查询候选
先根据上下文推断 1–3 个稳定术语，再用一个命令批量验证：
node "<skill-root>/scripts/vibehub.mjs" resolve \
--query "<候选术语 1>" \
--query "<候选术语 2>" \
--compact
- 高置信度时只传一个候选；存在歧义时才增加候选，最多三个。
- 不要把用户整句原话直接当作搜索词。
- 比较标题、别名、定义和匹配字段，只采用真正符合当前场景的结果。
--compact 足以确认时直接完成回答；只有摘要无法判断边界时，才对最终候选去掉 --compact 再查一次。- 只使用解析器返回的
url，不要自行拼接或伪造链接。
- 没有可靠匹配时，仍先完成当前任务；只有用户明确索要词条时才说明暂无页面。
查询只传脱敏后的短术语，不传源代码、密钥、客户信息、内部网址、邮箱、本地路径或项目材料。
表达原则
- 先交付任务结果，再补术语。
- 使用自然、通俗的中文或英文。
- 一个判断只说一次。
- 术语用于帮助下一次表达，不用于展示专业感。
