YouTrack 命令行全能管家

JetBrains YouTrack 官方 CLI 工具文档，支持 issue 全生命周期管理与批量自动化操作，需用户主动配置 API Token。

基本信息

• 技能名称?youtrack
• 中文名称?YouTrack 命令行全能管家
• 作者?iAhmadZain
• 分类?开发
• 版本?v1.0.1
• 标签?project-program-management, development-engineering, devops, automation, productivity, backend

使用方法

使用说明
核心用法
YouTrack CLI Skill 提供完整的命令行 issue 管理能力，覆盖 YouTrack 项目管理的核心场景。用户通过 ytctl 脚本与 YouTrack API 交互，支持项目列表查询、issue 增删改查、评论添加、状态流转等操作。查询语法完全兼容 YouTrack 原生查询语言，支持 state: Open 、 、 assignee: me 、 、 created: today 等复杂条件组合，并可配合 sort by 进行结果排序。
批量操作是本 Skill 的亮点功能，， bulk-update 、 、 bulk-comment 、 、 bulk-assign 等命令支持对匹配查询条件的 issue 进行批量处理，且内置 --dry-run 预览机制，避免误操作风险。报告生成功能可输出项目摘要、用户活动统计、状态分布可视化等管理报表。
显著优点

1. 原生查询语法支持 ：无需学习新语法，直接使用 YouTrack 成熟的查询语言
2. 批量操作安全设计 ：所有批量命令均支持 --dry-run 预览，操作前可见影响范围
3. 灵活的配置方式 ：支持配置文件（ ~/.config/youtrack/config.json ）或环境变量两种凭证管理方式
4. 输出格式可选 ：默认表格格式便于阅读，， --json 选项便于脚本集成和数据处理
5. 轻量依赖 ：仅需 jq 和 curl 两个标准系统工具，无复杂运行时依赖
   潜在缺点与局限性
6. 外部工具依赖 ： ytctl 脚本需单独安装，Skill 本身仅提供使用文档
7. 网络依赖性强 ：所有操作均需连接 YouTrack 实例，无法离线使用
8. 功能边界限制 ：仅覆盖 issue 管理场景，不包含 YouTrack 的敏捷看板、时间跟踪等高级功能
9. Token 管理成本 ：用户需自行在 YouTrack 后台生成和管理 API Token
   适合的目标群体
   开发团队技术负责人，需要批量管理项目 issue 状态
   DevOps 工程师，希望在 CI/CD 流程中集成 issue 自动流转
   项目经理，需要定期生成团队活动报告和状态统计
   习惯命令行工作流的高级用户，追求效率最大化
   使用风险
10. Token 泄露风险 ：配置文件若权限设置不当（非 600），可能导致 API Token 被其他用户读取
11. 批量操作误伤 ：虽支持 --dry-run ，但用户跳过预览直接执行可能造成大规模数据变更
12. API 限流影响 ：高频批量操作可能触发 YouTrack 实例的 API 限流策略
13. 依赖工具缺失 ：目标环境若未安装 jq 或 curl ，脚本将无法正常运行