用途:运行累积式 YouTube 研究流程。因发现与授权获取可能访问网络并写入本地源文件,应在主会话中执行,以打包的 yt-insights 研究 CLI 为唯一事实来源;只读 MCP 仅可用于单独的本地查询,不得用于研究状态变更。
启动与恢复:用 yt-insights research start "TOPIC" --query "QUERY" --freshness-profile standard --json 启动,查询需显式给出 1 至 8 个。用 yt-insights research status SESSION_ID --json 恢复,并原样保留返回的 session ID 和 revision。无效 JSON 或未知 schema 视为未验证状态,应停止并给出有限错误,不得推断命令、修订、候选或结果。每次变更需生成新的幂等键,仅重放完全相同请求时可复用。
人工决策:按 required_user_action 字面执行。confirm_sufficiency_or_refresh 时,用 yt-insights research decide SESSION_ID sufficient|refresh --revision REVISION --idempotency-key KEY --json 记录。refresh 仅授权发现,随后 discover 并用 candidates 展示最多十个候选项(含 ID、标题、频道、发布日期、匹配查询、URL)。approve_candidates_or_cancel 时由用户选择 1 至 5 个确切候选 ID 或取消,不得代为批准。批准后用 acquire 仅获取已批准的确切视频 ID,不得替换、扩展到播放列表或频道。
输出与限制:充分性确认后,询问用户要档案、文章草稿、语料导出、两者或都不要。用 export 输出确定性证据,之后才撰写文稿,模型综合须与 YouTube 来源证据分离并说明未决问题与覆盖限制。缺少会话、修订过期、网络不可用或相关性门禁为 FAIL/UNKNOWN 时按失败即停原则处理;不通过本技能安装或修改全局配置。