核心用法
yandex-tracker 技能基于官方 yandex_tracker_client Python 库，提供对 Yandex Tracker API v2 的全功能封装。采用"脚本即工作流"模式：编写自包含 Python 脚本完成初始化、批量 API 调用、数据聚合与格式化输出，保存至 /tmp/tracker_script.py 执行。
核心能力覆盖：
- Issue 全生命周期：创建、查询、更新、状态流转（transitions）、删除
- 高级搜索：支持 Tracker Query Language 字符串或结构化 filter 字典，自动分页
- 批量操作：
bulkchange.update/transition/move支持数千条 Issue 的批量更新、状态迁移、跨队列移动 - 关联与协作：评论（含 @提及）、附件上传下载、Issue 链接（阻塞/依赖/重复等关系）
- 工时管理：ISO 8601 格式工时记录（PT1H30M）、跨 Issue 工时统计
- 自定义字段：动态发现队列特定字段（storyPoints 等），支持读写与筛选
- 敏捷支持：Sprint 分配、看板集成、队列管理
显著优点
1. 功能完整性：覆盖 Tracker 90%+ 的 API 能力，包括企业场景必需的批量操作与自定义字段
2. 开发效率：Reference 对象自动解析（.id/.display/.login），无需二次请求；惰性迭代自动分页，简化大数据量处理
3. 灵活性：支持 Yandex 360 与 Yandex Cloud 双组织模型，OAuth/IAM 双认证方式
4. 调试友好：as_dict() 方法可完整转储对象结构，便于字段发现
潜在缺点与局限性
- 学习成本：需熟悉 Tracker 领域概念（队列、transition、resolution）及 Python 异步/迭代模式
- 环境依赖：强制要求 Python 3 与 pip 安装，无原生 REST/CLI 备选路径
- 认证配置：需手动配置
TRACKER_TOKEN+TRACKER_ORG_ID/TRACKER_CLOUD_ORG_ID，无交互式授权流程 - 错误处理：需显式捕获
NotFound/Forbidden/Conflict等异常，默认不自动重试并发冲突 - 云生态锁定：深度绑定 Yandex 生态系统，迁移至 Jira/Azure DevOps 需重写
适合人群
- 中大型研发团队：需要批量处理、自定义工作流、复杂权限模型的场景
- DevOps/自动化工程师：构建 CI/CD 集成、自动化工单处理、报表生成
- 项目经理/Scrum Master：需编程方式批量更新 Sprint、生成统计报表
常规风险
- 令牌泄露：OAuth/IAM Token 存储于环境变量，存在被进程/日志窃取风险
- 批量操作不可逆：
bulkchange无内置预览机制，误操作可能影响数百条 Issue - 并发冲突：多用户同时修改同一 Issue 时触发
Conflict异常，需应用层重试 - 数据泄露：通过
find()可遍历全组织可见 Issue，需确保最小权限原则配置 Token