用途
sweeper-query 用于回答关于 VS Code Sweeper 已发布 issue 索引的自然语言问题。Sweeper 每晚审查 microsoft/vscode 及一组登记仓库的全部开放 issue，并按仓库发布一个 JSON 索引；每行包含审查结论、价值评分、agent 就绪层级、重复项的标准 issue、指派人、标签和生命周期时间戳。
主要能力
- 将自然语言问题映射为对索引文件的 jq 查询，并输出简短表格。
- 支持按仓库选择索引：默认 microsoft/vscode（index-vscode.json），其他仓库通过 targets.json 名册解析，不从记忆猜测。
- 支持常用查询：开放 issue 默认筛选、标签精确匹配、指派人（“我的 issue”）、可实施/可规划就绪状态、按价值排序、时间窗口、重复项提案、隐藏已忽略行。
- 针对单个 issue，可读取索引行背后的审查记录，包括 Summary、Evidence（文件与行号引用）、重复项搜索、修复简报或计划简报、完整拟定评论等。
- 可作为其他技能或脚本的发现步骤，以机器模式输出 jq -c JSON 行。
使用方式
先确定仓库，再从状态仓库 egamma/vscodesweeper-state 获取并缓存索引，并在每次查询前用文件最新提交 SHA 校验缓存；校验或下载失败即停止，不用过期缓存作答。随后编写 jq 查询，按回答格式渲染为 Markdown 表格，链接为 https://github.com/<repo>/issues/<n>。单 issue 记录通过 gh api 读取 records/<repo>/items/<n>.md，404 表示未被审查。机器模式输出 JSON 行并注明 generatedAt。
适用场景
- 查询某区域本周有哪些审查提案。
- 提交前检查是否为已知重复。
- 挑选可实施的 papercut。
- 按价值列出某指派人的开放 bug。
- 了解某个 issue 的审查发现与证据。
限制
- 只读，仅用于发现；不评论、不打标签、不关闭、不反应、不编辑任何 issue，也不写入状态仓库。
- 索引是审查时快照；owner、标签、就绪状态和开放状态均非实时。
- 行动前调用方需自行对 GitHub 做只读复核（仍开放、无安全标签、无开放 PR、指派人未变）。
- 索引为空稀疏结构，缺失键即默认值。
- 重复项 canonical 只是提案；只有 verifyVerdict 为 confirmed 且无 verifyStale 才算确认。
- 标题搜索不是语义搜索。
- 证据行号随 main 漂移。