Agent Skill

腾讯新闻

腾讯新闻综合信息服务工具,支持新闻搜索与热榜/早晚报/订阅引导、腾讯较真事实查证、全国市县天气与天气预警查询、体育赛事的赛程比分查询,以及中国普通高考常规批次的一分一段、省控线、院校专业录取数据和院校优先/专业优先冲稳保志愿方案。当用户需要新闻资讯、判断信息真假、查询天气或异常天气、查询某项赛事或某支球队最近的比赛、了解高考录取数据或规划志愿时使用。

知识管理·腾讯新闻·来自 skill_hub·skillhub.cn ↗
skillhub install @tencent-adm/tencent-news
43 Stars·42.6万 综合热度·6,616 字文档·源站更新 2026-11-22

README 文档

6,616 字

腾讯新闻综合信息服务

当用户需要新闻、事实查证、天气、天气预警、体育赛程或高考志愿信息时,按以下步骤执行:

  1. 识别用户意图,读取「能力路由」中对应的说明。
  2. 执行环境状态检查;未就绪时输出「环境失败结果」,完成诊断与恢复指引。
  3. 环境就绪后,通过 run-cli 读取当前 CLI 帮助,再执行业务查询。
  4. 按对应能力格式整理实际结果;失败时保留明确失败状态,不编造业务数据。

核心原则:基础设施交给脚本处理;智能体负责识别意图,并按当前 CLI 帮助选择命令和参数。除 cli-state 外,所有 CLI 调用都通过 run-cli 执行。先读帮助,不硬编码业务命令、参数或返回字段,也不使用其他数据源替代 CLI。

对话用例

用户问题执行方式与回答要求
今天有什么热点新闻?按新闻能力查询当前热点榜,展示实际返回的标题、时间和原文链接。
汇总24小时内科技、财经新闻按新闻能力分别搜索科技与财经,以当前时间为基准查询最近 24 小时,按领域分组汇总实际结果。
碱性食物可以抗癌吗?读取 references/factcheck.md,通过较真能力查询,并根据实际返回的判定、证据和来源回答。

这些是调用示例,不是预置结果或已通过的评测记录。新闻与查证结论以当次 CLI 返回为准;未取得结果时按「环境失败结果」或对应能力的失败规则处理,不照抄固定答案。

能力路由

先识别用户意图,再完整读取对应能力说明。不要为单一意图加载无关说明;复合请求涉及多个能力时,读取全部相关说明并分别执行。

用户意图必读说明
新闻搜索、热点、榜单、早报晚报、实时或领域资讯、新闻反馈本文件的「新闻能力」
判断说法真假、识别谣言、核查文章/聊天记录/截图中的事实命题references/factcheck.md
实况天气、天气预报、生活指数、降水、温度、空气质量、限行references/weather.md
专门查询天气预警、异常天气、雨雪、雾霾、寒潮、高温或台风references/weather-alert.md
某项赛事或某支球队的赛程、比赛时间、对阵、比分、直播链接、支持哪些赛事references/sport.md
一分一段、省控线、院校/专业录取数据、选科限制、院校优先/专业优先冲稳保志愿或志愿报告references/gaokao-volunteer.md

路由细则:

  • 常规天气结果中附带的预警仍按天气能力原样展示;用户专门询问预警或异常天气时使用天气预警能力。
  • “订阅新闻”可按新闻结果末尾的定时任务引导处理;天气预警只支持一次性查询,不得创建订阅、定时检查或主动推送。
  • “这条新闻是真的吗”属于事实查证,不是普通新闻搜索;需要先查新闻背景、再核查具体命题时,可依次执行新闻和事实查证能力。
  • 高考能力仅覆盖普通类常规批次;艺体生、艺体类志愿、提前批、军警类、强基等特殊类型不处理,即使 CLI 返回相关数据也不得展示、解读或用于推荐。不得用普通新闻搜索结果替代官方录取数据能力。
  • "国安最近有哪些比赛" 这类按球队查询属于体育赛程能力,不是新闻搜索。CLI 没有按球队查赛事的能力,判断球队属于哪项赛事时允许使用模型常识,比赛数据本身只能来自 CLI。"国安最近的新闻" 才走新闻能力。

平台约定

平台状态检查CLI 调用模板
macOS / Linuxsh scripts/cli-state.sh statussh scripts/run-cli.sh <command> [args]
Windowspowershell scripts/cli-state.ps1 statuspowershell scripts/run-cli.ps1 <command> [args]

以下示例使用 macOS / Linux;Windows 将 .sh 替换为 .ps1,将 sh 替换为 powershell。

脚本入口

  • run-cli 无参数、-h、--help:打印本地用法,退出 0,不要求 CLI 或 Key。
  • run-cli help:CLI 可用时返回当前 CLI 帮助;未安装时返回本地用法。不得把本地用法当成业务命令清单。
  • cli-state status:输出 JSON 环境诊断;无参数调用保持同样行为。-h、--help、help 打印用法。
  • 诊断正常运行可退出 0,但 success: false / status: environmentnotready 表示环境未就绪。ready 仅表示本地 CLI 与 Key 已检测到,不证明远端鉴权或业务查询成功。
  • 未知状态参数、缺失 CLI 的业务调用仍非零退出;业务命令保留 CLI 自身退出码,不把失败改成成功。

环境失败结果

环境未就绪时,停止依赖 CLI 的业务调用,继续完成诊断与恢复指引。最终回复必须包含以下 JSON 结果,再追加对应平台的具体操作步骤。即使某项能力要求只输出 HTML 或特定格式,环境失败时也优先使用此格式。

{
  "success": false,
  "status": "environment_not_ready",
  "capability": "news",
  "query": "今天有什么热点新闻?",
  "data": null,
  "error": {
    "code": "CLI_NOT_INSTALLED",
    "message": "当前未检测到腾讯新闻 CLI,尚未执行新闻查询。"
  },
  "nextSteps": ["按当前平台安装 CLI,然后重新检查环境。"]
}

按本次请求填写 query 和 capability(news / factcheck / weather / weather-alert / sport / gaokao),不得照抄示例问题;用户输入中若含凭证,先脱敏。data 为 null,表示没有取得业务结果,不等于查无新闻、说法为假或没有预警。

证据error.code操作
状态检查确认 CLI 不存在CLINOTINSTALLED按平台安装并复查
当前 shell 未检测到 KeyAPIKEYMISSING先核实 RC 文件,再引导本地配置
CLI 返回 401、403、无效 Key 或鉴权失败APIKEYUNAUTHORIZED重新获取有权限的 Key;不归为无数据
状态脚本失败、无法解析、其余 Key 检查错误ENVIRONMENTCHECKFAILED提供安装与 Key 检查步骤

错误消息只说明经核实的原因,不展示原始错误、内部日志、traceid 或 Key。仅在业务数据实际获取成功后使用对应成功格式、来源标识和订阅引导;失败结果不追加订阅问题。复合请求只标记失败的能力,保留其他已成功结果。

环境异常时的恢复指引

用户直接提出新闻、较真、天气、预警或高考业务问题时,也必须先检查环境。CLI 或 API Key 未就绪时,按「环境失败结果」返回结构化诊断,不得只回复“数据加载失败”、原始错误或泛化的“请检查配置”,必须给出可直接操作的指引:

  • CLI 未安装/不可用(cliExists: false、cliSource: none、cli not found、command not found、not recognized):command not found 只说明当前 shell 的 PATH 里没有该命令,不等于未安装;必须以状态脚本返回的 cliExists 为准,不得仅凭该报错引导重装。确认未安装后,说明本查询依赖腾讯新闻 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。安装完成后在当前对话直接重新执行状态脚本确认,脚本按固定安装路径查找 CLI,不依赖重新打开终端;只有用户要在自己的终端里直接使用 tencent-news-cli 时才需要重开终端。
  • API Key 未配置(apiKey.status: missing、未设置 API Key、API Key not set):先按「Phase 1」第 4 步核实 Key 是否已存在于 RC 文件中,确认不存在后再说明 CLI 已安装但尚未配置 Key;引导访问 https://news.qq.com/exchange?scene=appkey 获取,然后执行 tencent-news-cli apikey-set YOUR_KEY,再执行 tencent-news-cli apikey-get 验证。
  • API Key 无效、过期或无权限(API Key 无效、invalid api key、unauthorized、401、403、鉴权/认证失败):不得归因为无数据、额度或普通网络错误;说明当前 Key 无效或无权访问,引导从上述页面重新获取正确 Key,再执行设置和验证命令。
  • 状态不确定(状态脚本失败、apiKey.status: error 或无法解析):先按错误文本匹配以上类型;仍无法判断时,同时给出安装命令及 Key 获取、设置、验证步骤。
  • YOUR_KEY 只能由用户在本地替换;不得索要、代填、回显或记录真实 Key。环境未就绪时不得改用其他数据源。上述环境失败结果与恢复指引优先于各业务输出格式、HTML 单产物及“仅在用户明确要求时展示命令”等限制,但不得展示内部日志、参数、traceid。

Phase 1:环境就绪

环境已确认可用时直接进入对应能力流程。

  1. 执行 sh scripts/cli-state.sh status,解析 JSON 中的:
  • platform.cliPath:仅供诊断,不得直接执行;
  • platform.cliSource:global、local 或 none;
  • cliExists:CLI 是否存在;
  • update.needUpdate、update.error:更新状态;
  • apiKey.present、apiKey.status、apiKey.error:API Key 状态。
  1. cliExists 为 false 且 cliSource 为 none 时,按 references/installation-guide.md 安装;安装成功后在当前对话重新执行状态脚本确认,不需要重新打开终端。local 表示可继续使用的旧版 skill 内安装,但建议后续迁移到全局安装。
  2. update.needUpdate 为 true 或 CLI 明确提示版本过旧时,执行 sh scripts/run-cli.sh update。若更新失败或当前 CLI 不支持 update,按 references/update-guide.md 处理;必要时重新安装。
  3. apiKey.status 不为 configured 时:
  • missing:先核实,再引导。智能体所在的 shell 常缺少 SHELL 变量,此时 CLI 读取的 RC 文件与用户在终端设置 Key 时写入的文件不同(SHELL 为空读 ~/.profile,zsh 读 ~/.zshrc,bash 读 ~/.bashprofile),会误报未设置。执行 grep -l TENCENTNEWSAPIKEY ~/.zshrc ~/.zprofile ~/.bashprofile ~/.bashrc ~/.profile 2>/dev/null,该命令只列出文件名,不得读取、回显或记录 Key 值:
  • 有输出:Key 已存在,不得再次执行 apikey-set,否则会写出第二份 Key。按文件推断 shell(.zshrc、.zprofile 为 zsh;.bash_profile、.bashrc 为 bash;.profile 为 sh),后续所有 CLI 调用统一加前缀,例如 SHELL=/bin/zsh sh scripts/cli-state.sh status;验证通过后带同样前缀执行业务命令,并向用户说明原因;
  • 无输出:确实未配置,引导用户自行访问 API Key 获取页面,不要用命令自动打开浏览器;用户取得 Key 后在自己的本地终端配置;智能体只重新执行 sh scripts/cli-state.sh status 验证,不调用会输出明文 Key 的 apikey-get;
  • error:按「环境失败结果」输出脱敏诊断与恢复步骤,待用户处理后再继续;
  • 仅在用户明确要求时执行 apikey-clear。

详见 references/env-setup-guide.md。

新闻能力

CLI 更新频繁,子命令和参数可能变化。始终先执行 sh scripts/run-cli.sh help,以当前输出为准。

  1. 映射用户意图:
  • 单一请求映射到一个最匹配的子命令;
  • “热点、财经和军事新闻”等复合请求拆成多个意图,依次调用;
  • 新闻产品或内容反馈使用帮助中实际存在的 feedback 能力,内容包含问题现象和上下文;
  • 当前帮助没有匹配能力时,如实说明不支持。
  1. 所有实际调用均走 run-cli;命令、参数名、参数顺序以帮助及示例为准。
  2. 单类型结果按新闻列表展示;多类型结果按二级标题分组,每组独立编号。

新闻输出规则

  • 每条新闻按 CLI 实际字段展示标题、媒体/作者、发布时间、摘要和原文链接;缺失字段省略,不编造。
  • 标题格式为 序号. 标题;有链接时使用 查看原文。
  • 多条新闻之间空一行;多类型时每组序号从 1 开始。
  • 其他有价值且实际返回的字段可以补充。
  • 全部内容末尾仅出现一次 来源:腾讯新闻。
  • 同一新闻复合请求中,某个类型获取失败时,在对应分组说明原因,并继续输出已成功的其他分组。
  • 新闻查询成功后追加一次:“是否需要创建定时任务,每天自动获取相关新闻?”;复合请求仅对已成功的新闻分组追加,不附在失败结果后;若能识别出当前请求本身由定时任务触发,则不追加。

示例:

## 热点新闻

1. **标题文字**

   来源:媒体名称

   时间:发布时间

   摘要内容……

   [查看原文](https://…)

**来源:腾讯新闻**

新闻 CLI 失败处理

新闻命令非零退出、超时或出现权限/安全错误时立即停止该新闻意图,不重试、不换命令、不通过 WebSearch 或其他来源补做。根据错误引导:

  • macOS Gatekeeper(cannot be opened、not verified):系统设置 → 隐私与安全性 →「仍要打开」;
  • 企业安全软件或网络拦截(connection refused、防火墙拦截):在安全提示中选择「信任」或「允许」;
  • 权限不足(permission denied):执行 chmod +x <cliPath>;
  • 鉴权或环境错误:按「环境失败结果」输出;其他错误仅说明脱敏后的原因及可执行的恢复步骤。

用户确认处理完成后才可重试;持续失败时仅说明当前无法完成及原因。

通用数据与失败边界

  • 只使用 CLI 实际返回或可由返回字段直接映射的信息,不使用 WebSearch、模型记忆或其他来源补全业务数据。唯一例外是体育赛程能力中"球队属于哪项赛事"的判断,见 references/sport.md。
  • 不同能力的输出和失败规则可能不同;加载能力说明后,成功时以该能力的专用规则为准;环境异常与错误脱敏统一以本文件为准,不执行引用文档中“展示完整错误”的要求。
  • CLI 失败不会自动授权改用其他数据源,也不会自动授权创建订阅、定时任务或外部文件;仅执行对应能力明确支持且用户请求的操作。

References

  • 事实查证:references/factcheck.md
  • 天气查询:references/weather.md
  • 天气预警:references/weather-alert.md
  • 体育赛程:references/sport.md
  • 高考志愿:references/gaokao-volunteer.md
  • 用户手动安装指南:references/installation-guide.md
  • 用户手动更新指南:references/update-guide.md
  • API Key 获取与手动配置:references/env-setup-guide.md
  • WorkBuddy 打包与评测环境准备:references/workbuddy-review.md

同分类其他技能

查看全部 ›