| name | jira-issue |
| description | Jira Issue 创建与提交。用于通过脚本创建/提交 Jira Issue(Bug/Task 等)、设置标签/组件/负责人/优先级,或需要预览/打印请求 payload 时使用。 |
Jira Issue 创建与提交
概述
使用脚本通过 Jira REST API v2 创建 Issue,默认读取 .env 中的凭据。
工作流
- 明确项目、Issue 类型、标题与描述。
- 可先用
--print-payload 或 --dry-run 预览。
- 提交后记录返回的 key/self。
脚本
脚本:.codex/skills/jira-issue/scripts/jira_create_issue.py
用法:
uv run python3 .codex/skills/jira-issue/scripts/jira_create_issue.py \
--project-key <PROJECT_KEY> --summary "..." --description "..."
常用参数:
--env-file:默认 .env,读取 JIRA_URL、JIRA_TOKEN、JIRA_USER
--auth:bearer 或 basic(默认 bearer)
--project-key:也可用 JIRA_PROJECT
--issue-type:也可用 JIRA_ISSUE_TYPE,默认 Bug
--description-file:从文件读取描述
--label/--component/--assignee/--priority
--affects-version/--fix-version:对应 Affects Version / Fix Version(可重复)
--print-payload/--dry-run
输出:key 与 self(若返回)。
评论 Issue
脚本:.codex/skills/jira-issue/scripts/jira_comment_issue.py
用法:
uv run python3 .codex/skills/jira-issue/scripts/jira_comment_issue.py \
--issue-key DORIS-12345 --comment "..."
常用参数:
--issue-key:目标 Issue key
--comment / --comment-file:评论内容
--print-payload / --dry-run:预览请求
注意事项:
--assignee 使用 Jira 用户名(不是邮箱),如 laihui
经验示例(回归发版测试失败用例):
uv run python3 .codex/skills/jira-issue/scripts/jira_create_issue.py \
--project-key DORIS \
--issue-type Bug \
--summary "回归发版测试 S3 load 因内存超限失败(regression-release #2318/#2314)" \
--description "..." \
--priority Highest \
--assignee laihui \
--label 存储小组 \
--label 导入 \
--affects-version enter-3.1.4 \
--fix-version 3.1.4