关于 rhdh-jira-create
rhdh-jira-create 面向 RHDH 团队,负责判断 Jira 问题类型、访谈收集信息、按 RHDH 模板起草,并在确认后创建问题。它为外部写入设置了检查流程,并会回读已创建的问题。
主要功能
- 01选择问题类型和项目
- 02引导式收集问题详情
- 03按 RHDH 模板起草
- 04查重并取得确认
- 05创建并核验 Jira 问题
适用场景
- 01将支持案例转为 Jira 问题
- 02起草并创建 Feature、Epic 或 Story
- 03创建带必要隐私设置的问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-jira-create安装后在 Claude Code 中输入/rhdh-jira-create确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/support-intake.mdworkflows/create-issue.md详细介绍
创建 RHDH Jira 工作项
一个用于处理“这应该是个工单”的技能。它会决定问题类型和项目,进行访谈,根据 RHDH 模板起草内容,并创建问题。
调用者说“在 Jira 中提交”时,几乎从来不知道自己需要的是 Feature、Epic 还是 Story。判断类型是此技能的职责。判断错误会把错误的问题类型写入公共项目,因此必须提前明确做出判断,并由用户确认后才能创建任何内容。
路由
加载 workflows/create-issue.md。一个工作流涵盖层级中的所有级别——类型判断是第一个实际步骤,其后的步骤则会汇合。
如果工作源自支持案例,则添加 references/support-intake.md:例如 RHDHSUPP 对话、客户升级、SLA 问题,或将案例转为缺陷或功能请求的请求。
Grilling 是硬性门槛
创建需要外部 grilling 技能。它不包含在此工具包中。如果宿主无法按名称调用该技能,请在创建任何内容之前停止,说明创建需要通过 grilling,并指出 /setup-rhdh-skills install。切勿探查宿主技能目录、擅自安装该技能,或临时编造替代访谈。
/rhdh-jira-authoring 承担访谈中的 RHDH 部分——挑战矩阵、字段推断、规模评估和模板。请按名称调用它。
每次创建都是一次外部写入
在任何会创建、关联、评论或编辑的 acli 命令之前,调用 /mutation-gate 并遵循其要求。一次创建很少只涉及一个操作——创建、创建时无法携带的字段更新、父级关联和评论,都应纳入同一组已说明的操作,以便一次审批涵盖全部操作。
之后,回读问题。如果创建成功,但随后的字段更新悄然失败,这就是只创建了一半的问题,不能算成功。
私有问题不能“创建后再设置”。 对于公共项目(RHIDP、RHDHPLAN、RHDHBUGS),应在创建载荷中设置 security(/rhdh-jira-api — 私有问题)。RHDHSUPP 是项目私有的;级别可选。切勿先创建再限制可见性。如果在需要时无法设置 security,请停止。
与相邻技能的职责边界
- 判断现有问题是否已准备就绪:
/rhdh-jira-refine。 - 更改已知键对应的问题状态、经办人、评论或关联:
/rhdh-jira-update。 acli语法、字段 ID、组件目录和工作流退出条件:/rhdh-jira-api。- 模板、挑战矩阵、规模评估、重复项检测和拆分规则:
/rhdh-jira-authoring。 - 创建 PR 并将其关联回问题:
/rhdh-jira-link。
完成条件
只有在用户于创建前确认了问题类型、已运行重复项检查并报告其结果、已完成 grilling 访谈,且每个已创建的键都已回读并报告其最终状态、父级关联及实际设置的字段后,才算完成。将 API 拒绝设置的任何字段报告为未设置,绝不能报告为已设置。只有在用户批准批次表之后才创建任何子项,并且表中的每个子项都有对应的键或明确说明跳过原因,拆分任务才算完成。