UHD_Media_Tool/packages/agent/skills/download-diagnose/SKILL.md

name, title, description, triggers, capabilities, sessions

name	title	description	triggers	capabilities	sessions
download-diagnose	下载排查	看下载进度、找失败或卡住的下载并说明原因，必要时在授权内重新校验或重试。用户问「下载怎么样了」「有没有失败的下载」「为什么卡住」时用。	下载(任务)?.{0,8}(失败|卡住|卡了|慢|进度|怎么样|情况|无进展|报错|完成了吗|好了没) (有没有|哪些).{0,6}(失败|卡住).{0,4}(下载|任务) 做种.{0,6}(问题|失败)|文件缺失|missing|stalled 巡检下载|下载诊断	download.list download.inspect task.inspect download.recheck task.retry downloader.list	chat patrol investigate child

适用意图

• 「下载怎么样了」「有没有失败的下载」「《X》为什么卡在 40%」。
• 定时的「下载诊断」巡检，和下载失败 / 无进展触发的后台调查。

步骤

1. download.list：问整体情况时不带筛选，看按状态计数；问失败或卡住时按状态筛（failed、missing、stalled）；问某部作品时带作品名。
2. 下载器本身连不上会让所有任务停住：失败很多时先看「当前环境」或 downloader.list 的下载器状态。
3. 对需要说明原因的 1–3 个任务调用 download.inspect，读错误、关联的提交下载 / 核验入库任务和待处理事项；需要任务时间线时 task.inspect。
4. 授权内恢复（只在用户要求或后台恢复会话里）：文件缺失、出错用 download.recheck（action=recheck），非人工暂停用 action=resume；失败的业务任务用 task.retry。每个任务最多一次。

需要批准

• download.recheck、task.retry 需要持续授权；没有授权时写一句「没做：重新校验「名称」，需要你批准」。
• 换源、删除不在这个 Skill 里，也没有对应能力。

汇报模板

3 个下载有问题：《沙丘：第二部》文件缺失（下载器找不到数据文件），2 个剧集无进展超过 6 小时。其余 12 个正常下载中。

下载都正常：4 个下载中（最快的 83%），2 个已完成待整理。

• 3 个以上有问题的任务可以用表格：名称 / 状态 / 原因，不放 ID 和 hash。

不要做

• 不要向用户要下载任务 ID 或种子 hash，自己用 download.list 找。
• 不要自动换源、删除种子或改保存路径。
• 不要对同一个任务反复 recheck 或 retry。
• 不要写原始字节数和下载器的英文状态码，换成中文说法（文件缺失、无进展、已暂停）。