ONES 数据查询助手

解决什么问题

在 ONES 里找一个具体项目、延期任务或迭代进度，通常要先打开页面、记下 team、再按类型和状态过滤。真正麻烦的是跨项目排查：哪些缺陷超期超过一周、我负责的需求按优先级怎么排、某个迭代按状态拆开后还剩多少未完成。手动点列表等于重复搬运字段；本地脚本则要处理 token、端点、分页和日期格式。

它是怎么工作的

这个技能把「自然语言问题」转成一次只读查询：

• 解析意图：按用户提到的对象选择 action，例如项目列表对应 projects，任务/需求/缺陷对应 issues，延期对应 overdue，迭代对应 sprints，看板对应 kanban。
• 执行路径：优先检测本机 Python；有则运行 scripts/ones_query.py，没有则走 curl / Invoke-RestMethod 调 ONES API。
• 认证读取：依次读取环境变量 ONES_TOKEN、配置文件 ~/.ones_query.json，再考虑一次性配置；支持个人 PAT 和 OAuth 两种方式。
• 结果整理：脚本返回结构化 JSON，包含 data、total、scanned、has_more、next_cursor 等字段，再按中文表格、状态徽章、延期颜色和文字进度条输出。
• 分页策略：默认只取最近前 N 条，避免全量扫描长时间等待；用户明确要更多时，才用 --cursor 翻页或 --all 全量。
• 聚合口径：状态分布、迭代进度、延期和看板默认基于前 N 条，输出中会标注统计范围。

适用边界与注意点

• 仅做查询，不执行创建、编辑或删除；遇到写操作请求会明确拒绝。
• token 与凭据保存在本机环境变量或配置文件中，仅使用只读令牌；共享屏幕、截图或日志时注意泄露风险。
• 服务端过滤在部分实例上可能无效，客户端会在本地按类型、状态、负责人和关键词再过滤一次。
• 聚合统计不是全量结果；需要精确全量报表时，应明确要求 --all 并接受更长等待时间。