用途：用 orbit CLI 以命令行方式操作 Jira，覆盖 issue 的增删改查与状态流转，以及冲刺、Epic、面板、过滤器、字段、屏幕等管理；兼容 Jira Cloud（REST API v3，描述用 ADF）与 Server/Data Center（REST API v2，描述用 wiki markup）。
前提与安装：需已安装 orbit CLI 并配置 jira-cloud 或 jira-onprem 服务档，凭据为 Cloud 的邮箱+API token 或 Server 的 PAT。安装命令：brew install jorgemuza/tap/orbit；curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh；Windows 用 scoop bucket add jorgemuza https://github.com/jorgemuza/scoop-bucket && scoop install orbit。
主要能力：issue view/create/edit/move/comment/attach/attachments/download/detach/delete/list；Epic 创建（自动设置 Epic Name，可用 --epic-name 覆盖）；搜索支持 JQL 与 --fresh；导出 Epic 层级为 markdown 目录；sprint list/view/create/start/close/update/add/remove/delete；dashboard 及 gadget 管理；filter 增删改查；field 列表/创建/上下文/选项（仅 Cloud）；screen 标签与字段分配；status 与 issuetype 列表。
必要用法：命令形如 orbit -p <profile> jira <resource> <action> [flags]；-o 控制输出为 table（默认）、json、yaml；-F 设置自定义字段，多选字段需用 [{"value":"X"}] 数组格式，单选可用 value:X；--field 设置任意自定义字段 key=value；Server 的 --body 必须用 wiki markup；查看评论用 issue view --comments N，写评论用 issue comment。
限制：action 均为叶子命令，不存在 <action> list，请查 references/commands.md 而非猜测；写操作把 issue key 作为首个位置参数，误拼子命令可能触发真实写入；issue list 依赖最终一致的 JQL 索引，可能滞后 30–60 秒，需最新结果时加 --fresh 并先用 issue view 核实单个 key；--cascade 只删 Sub-task，不删 Epic 下的 Story 或 Capability 下的 Epic，完整层级删除需先查子项再自底向上删除；Epic 不能用 --parent，应通过 customfield_27521（Parent Link）设置；field create/context-list/option-list/option-add 仅 Cloud；删除无 --confirm 或 --force，立即执行。凭据可用 1Password 的 op:// 或 Infisical 的 infisical:// 引用，运行时解析，可用 orbit auth 缓存以减少生物识别提示。