前言¶
大模型对话里，用户常会甩来一句「真的假的」「是谣言吗」，或贴一段资讯、聊天记录让你判断真伪。模型若只靠自身知识回答，容易过时、缺出处，也难交代「怎么查的」。把查证交给专门能力、并把结论与来源结构化返回，是更稳妥的做法。下面介绍 SkillHub 上的 较真查真假（@tencent-adm/jiaozhen-factcheck）：它把腾讯新闻 CLI 的较真能力封装成 Agent Skill，在需要事实核查时由智能体按流程调用，而不是在对话里即兴发挥。
这是什么¶
较真查真假 是面向 Agent 的 事实查证工具：对用户输入的具体说法、资讯、事件或常识做真实性、准确性、可靠性判断。Skill 坐标为 @tencent-adm/jiaozhen-factcheck，当前 SkillHub 版本为 1.0.3，分类为 knowledge-management，来源标注为 enterprise，发布者显示为「较真查真假」；Skill 元数据中的作者字段为 TencentNews。官方入口：SkillHub 页面，资源地址 https://api.skillhub.cn/tencent-adm/jiaozhen-factcheck。
它解决的是：在「较真一下」「能否 xxx」「可不可以」等查证类意图下，让 Agent 走统一的环境检查、CLI 调用与结果展示规范，而不是自行编造来源或改用网页搜索补查。
核心功能¶
依据 Skill 包内 SKILL.md 与参考文档，已核实的能力包括：
- 触发场景：当用户需要查证问题、判断信息真伪、识别谣言，或使用「是真的吗」「真的假的」「是谣言吗」等表述时，由 Agent 调用本 Skill。
- 底层能力：通过
tencent-news-cli的较真（jiaozhen）子命令完成查证；业务命令以运行时help jiaozhen输出为准，不硬编码固定子命令。 - 环境门禁：调用前先检查 CLI 是否安装、是否需要更新、API Key 是否配置；未就绪时停止业务查询，并给出可操作的安装或 Key 配置指引。
- 多形态输入：短命题直接查证；长文本、文章、聊天记录可提炼 1～3 条可核查命题；图片类内容由 Agent 先做视觉理解再提炼命题后查证（若无法识别则请用户提供更清晰材料或文本）。
- 结果呈现：以 CLI 返回的 完整 Markdown 作为答复主体，保留如「查证结论」「查证过程」「查证结论信心评估」及来源标题、链接等结构，不擅自摘要改写。
- 额度与失败策略：CLI 与 Key 正常且错误明确表示当日额度用尽时，按 Skill 说明处理（CLI 侧 每天 3 次 较真查证额度）；执行失败或输出为空时 不得 用 WebSearch 等方式自行补查。
SkillHub 标签含 requires_api_key=true，使用前需配置腾讯新闻 CLI 的 API Key。
安装与启用¶
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¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install jiaozhen-factcheck --namespace tencent-adm --dir <你的 skills 目录>
在 Cursor 中，常用 skills 目录为：
~/.cursor/skills/
也可按 SkillHub 安装说明，让 AI 执行：安装 @tencent-adm/jiaozhen-factcheck。
SkillHub 页面展示的检索安装形式为：
skillhub install jiaozhen-factcheck --namespace tencent-adm
（实际部署时仍建议加上正确的 --dir。）
3. 安装并配置 tencent-news-cli¶
Skill 依赖本机 腾讯新闻 CLI。macOS / Linux：
curl -fsSL https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.sh | sh
Windows PowerShell：
irm https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.ps1 | iex
安装后重新打开终端，可用 tencent-news-cli help 自检。
API Key：在浏览器打开 https://news.qq.com/exchange?scene=appkey 按页面指引获取，再在本地终端设置（勿把真实 Key 发给 Agent）：
tencent-news-cli apikey-set YOUR_KEY
tencent-news-cli apikey-get
Skill 目录内还提供 scripts/cli-state.sh（Windows 为 cli-state.ps1）用于检查 cliExists、apiKey.status 等状态；除状态检查外，CLI 调用应通过 scripts/run-cli.sh（或 Windows 的 run-cli.ps1）执行。
典型用法¶
启用 Skill 后，用户侧通常是自然语言提问，Agent 侧按 Skill 规定的两阶段流程工作。
Phase 1：环境就绪
在 Skill 根目录执行状态检查（示例为 macOS / Linux）：
sh scripts/cli-state.sh
若 cliExists 为 false，按上文安装 tencent-news-cli；若 update.needUpdate 为 true，可通过：
sh scripts/run-cli.sh update
更新 CLI。若 apiKey.status 不是 configured，引导用户在本地完成 Key 获取与 apikey-set。
Phase 2：事实查证
先查看当前版本支持的较真命令：
sh scripts/run-cli.sh help jiaozhen
根据帮助选择与子命令，把用户的命题或提炼后的可核查陈述作为参数传入（具体参数名与顺序以 help jiaozhen 为准）。执行成功后，将 CLI 返回的 Markdown 原文 作为回复主体交给用户。
用户提问示例（触发意图，非固定话术）：
- 「这条说法是真的吗：……」
- 「帮我较真一下，xxx 能不能 xxx」
- 「这是谣言吗？」
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的客户端里工作，且希望查证类问题走 腾讯较真 + 可引用来源 的开发者或内容从业者。
- 愿意在本机安装
tencent-news-cli并自行管理 API Key 的用户。
限制与注意
- API Key 必填（
requires_api_key=true）；Key 无效、过期或无权限时，应重新获取并本地配置，不能当成「无数据」或额度问题。 - CLI 日额度：Skill 说明在 CLI 明确提示时，按 每天 3 次 较真查证额度处理；用尽后可引导用户使用 较真 AI 智能查证 继续。
- 不要绕过 Skill：查证失败或输出为空时，Agent 不应改用 WebSearch 自行「补查」。
- 版本信息：SkillHub 登记版本为 1.0.3；包内
SKILL.md头部version字段可能为 1.0.2，以商店与_meta.json为准即可。 - 社区数据：SkillHub 页面统计（截至资料抓取）评分 100000，下载 2005，安装 11；安装量与 Key、CLI 环境相关，个人体验以本机环境为准。
结尾¶
较真查真假把「要不要信这条信息」从模型的自由发挥，收敛成 CLI 查证 + 结构化出处 + 固定失败与额度策略，适合挂在 Agent 上做知识管理类查证。若要在本机启用，可从 SkillHub 安装 @tencent-adm/jiaozhen-factcheck，并完成 tencent-news-cli 与 API Key 配置。官方 Skill 地址：https://api.skillhub.cn/tencent-adm/jiaozhen-factcheck；商店页：https://www.skillhub.cn/skills/tencent-adm/jiaozhen-factcheck。
