tldr 中的 `jira sprint` 命令：在 Jira 项目板上管理冲刺的实战指南

• 文档
• 教程
• 知识库

这是一篇以 tldr 仓库孟加拉语页面 pages.bn/common/jira-sprint.md 为核心的技术指南。该页面面向使用jira-cli（第三方 Jira 命令行接口）的开发者，讲解如何通过jira sprint子命令在 Jira 项目板中列出、筛选并管理冲刺（Sprint）。读完本文，你将掌握冲刺列表的两种调用形态（ls/list）、基于当前冲刺的筛选参数（--current）、按经办人与优先级组合过滤的技巧，以及通过交互式提示快速向冲刺添加事务（issue）的实战方法。

命令概览：jira sprint能做什么

jira sprint是 jira-cli 提供的用于管理Jira 项目板（project board）上冲刺的子命令。冲刺是 Scrum 方法论中的核心时间盒（timebox），通常持续 1~4 周，团队在冲刺内集中完成一组事务。

在 tldr 仓库中，孟加拉语页面jira-sprint完整描述了以下五类操作：

值得说明的是，jira sprint还有对应的别名命令jira sprints。仓库中的 pages/common/jira-sprints.md 明确指出该命令是jira sprint的别名（alias），其完整用法可查看tldr jira sprint。因此你在日常终端中两种写法均可使用。

前置条件：使用jira命令族的环境准备

孟加拉语页面的定位是具体子命令手册，因此它默认你已经完成了 jira-cli 的基础配置。结合仓库中更上层的 pages/common/jira.md 页面，使用前需要满足两点：

1. 安装 jira-cli 并初始化配置：首次使用前必须执行jira init创建配置文件。
2. 配置 API Token：jira-cli 是调用 Jira REST API 的第三方接口，需要获取 Jira API Token 并将其导出为环境变量$JIRA_API_TOKEN后，命令才能正常认证访问。

也就是说，本文中所有jira sprint命令，都依赖这个已认证、已配置的工作环境。配置完成后，jira sprint家族命令即可直接操作你在 Jira 中可见的项目与冲刺。

列出冲刺及其事务：资源管理器视图

最基本的用法是：

jira sprint {{[ls|list]}}

其中{{[ls|list]}}是 tldr 的选项占位符写法。根据仓库规范 CLIENT-SPECIFICATION.md：

• {{与}}包裹的是示例中可编辑的值；
• {{[与]}}表示选项的短写与长写变体，二者以|分隔，左侧为短写、右侧为长写；
• 客户端渲染时会移除花括号，并可根据用户选择仅显示短写或长写形式。

因此{{[ls|list]}}实际等价于jira sprint ls或jira sprint list——即你既可以用短写ls，也可以用长写list，效果一致。该命令会在**资源管理器视图（explorer view）**中展示当前项目的全部冲刺及其包含的事务，便于你快速纵览冲刺的分布与进度。

聚焦当前冲刺：--current参数

冲刺数量较多时，通常只关心当前正在进行的冲刺。使用--current参数可以只列出**当前冲刺（current sprint）**中的事务：

jira sprint {{[ls|list]}} --current

这一参数在与事务筛选条件组合时尤其有用，因为它把结果集收敛到"此刻正在进行"的时间盒内，避免把过去与未来的冲刺事务混入查询结果。它是整个筛选链的第一步。

组合过滤：按经办人与优先级筛选当前冲刺事务

jira-cli 的参数设计允许你用{{[-a|--assignee]}}（即-a/--assignee）指定经办人，用{{[-y|--priority]}}（即-y/--priority）指定优先级。二者可与--current任意组合。

列出当前冲刺中分配给我的事务：

jira sprint {{[ls|list]}} --current {{[-a|--assignee]}} $(jira me)

这里的$(jira me)是命令替换（command substitution）：它会先执行jira me，把输出的当前配置用户作为经办人值传给--assignee。仓库中的 pages/common/jira-me.md 页面专门解释了jira me的作用——显示已配置的 jira 用户，并同样给出了组合示例：

jira sprint {{[ls|list]}} --current {{[-a|--assignee]}} $(jira me)

这种写法避免了硬编码用户名，即使你切换了登录账号，命令依然能正确匹配"我自己"的经办人条件。

进一步按优先级过滤，只保留高优先级事务：

jira sprint {{[ls|list]}} --current {{[-a|--assignee]}} $(jira me) {{[-y|--priority]}} High

这条命令把三个条件叠加：当前冲刺（--current）+ 经办人为我（-a $(jira me)）+ 优先级为High。结果就是当前冲刺中需要我优先处理的高优事务清单。如果你希望看到中优先级或低优先级，把High替换为对应的优先级取值（如Medium、Low）即可，tldr 页面中High同样属于可编辑占位符值。

这一组合思路与 pages/common/jira.md 中的事务级筛选一脉相承，例如jira issue {{[ls|list]}} {{[-a|--assignee]}} x {{[-y|--priority]}} High用于列出未分配的高优先级事务，可以推断--assignee与--priority是 jira-cli 家族通用的过滤参数，覆盖事务（issue）与冲刺（sprint）两个层级。

向冲刺添加事务：交互式提示

除了查询与筛选，jira sprint还支持写入操作——向冲刺添加事务：

jira sprint add

与依赖记忆的长参数列表不同，add子命令会启动交互式提示（interactive prompt），引导你逐步选择要添加的事务以及目标冲刺。这种交互式流程的好处是：

• 不需要记住事务 ID 或冲刺名称的精确写法；
• 每一步都有选项供选择，降低误操作概率；
• 适合在终端中批量整理冲刺 backlog 的日常操作。

与其他 jira 命令的协作

jira sprint并非孤立存在，它与 jira-cli 的命令族共同构成完整的终端工作流：

• jira.md：总入口，负责init初始化、issue事务管理、open在浏览器打开事务等；
• jira-me.md：提供jira me，用于获取当前用户，配合$(jira me)实现"分配给我"的动态过滤；
• jira-sprints.md：jira sprint的别名页，两者等价；
• jira-project.md：管理 Jira 项目，可先jira project {{[ls|list]}}查看全部项目，再进入对应项目板管理冲刺。

在孟加拉语（pages.bn）目录下，上述 jira 系列页面（如 jira-browse.md、jira-issue.md、jira-project.md 等）均已提供了孟加拉语翻译，说明该命令族在 tldr 多语言体系中覆盖完整，jira sprint页面可以和其他子命令页配合查阅，形成完整的孟加拉语 Jira CLI 手册。

小结

围绕jira sprint，你可以用一张表格概括其核心能力：

使用时请记住三个要点：{{[ls|list]}}中ls与list等价；$(jira me)动态获取当前登录用户而非硬编码；--current、--assignee、--priority三个过滤条件可以自由叠加，从而把冲刺视图精确收敛到你真正需要关注的事务集合。配合 tldr 客户端渲染（花括号与方括号会被移除、选项占位符按短写/长写展示），这些命令可直接复制到终端运行。

• 文档
• 教程
• 知识库