前言¶
大模型對話裏,用戶常會甩來一句「真的假的」「是謠言嗎」,或貼一段資訊、聊天記錄讓你判斷真僞。模型若只靠自身知識回答,容易過時、缺出處,也難交代「怎麼查的」。把查證交給專門能力、並把結論與來源結構化返回,是更穩妥的做法。下面介紹 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。