SuperAPI AI 工具集

rhdh-jira-authoring

办公与效率

查看项目

更新于 10-16 02:10

技能介绍

RHDH Jira authoring 是一套用于撰写 RHDH Jira 工作项的写作规范与判断方法,决定一个 issue 在六个月后是否仍值得阅读。它被两个技能共用:/rhdh-jira-create 在起草时使用,/rhdh-jira-refine 在审计时使用,因此独立存在。该技能只产出文本和判断,从不运行 Jira 命令,也不执行任何写入。

按需加载

根据当前需要加载对应参考文档:

  • 如何质疑草稿、如何从对话引用中推断 RHDH Jira 字段:references/grill.md
  • T 恤尺码、故事点、RHDHSUPP 工作量点、规模质疑:references/sizing.md
  • 是否已经存在:references/duplicates.md
  • 将 Feature 拆分为 Epic,或将 Epic 拆分为 Story:references/work-breakdown.md

模板与示例

描述模板使用 Jira wiki 标记。每个模板旁边都有一个填写好的示例,用于校准语气与细节程度——起草前先读示例,因为仅凭模板无法说明 RHDH 评审者期望多少细节。

各 issue 类型对应的常用项目、模板与示例:

  • Feature:RHDHPLAN,assets/templates/feature.txt,assets/examples/feature-example.txt
  • Epic:RHIDP,assets/templates/epic.txt,assets/examples/epic-example.txt
  • Story:RHIDP,assets/templates/story.txt,assets/examples/story-example.txt
  • Task:RHIDP,assets/templates/task.txt,assets/examples/task-example.txt
  • Bug:RHDHBUGS,assets/templates/bug.txt,assets/examples/bug-example.txt

Spike 使用 Task 模板,在摘要前加 SPIKE: 前缀,并使用限时的故事点估算。Vulnerability 使用 Story 模板,且始终带有 Security 组件。RHDHPLAN 中存在 Feature Request 和 Outcome 模板;本技能不携带它们,因此请在 Jira UI 中依据项目自带模板起草。

子任务(Sub-task)是已有 issue 的子项,从不独立存在。

填写好的模板是 wiki 标记。当这些字节被塞进 ADF 文本节点而不是被转换时,Jira Cloud 会把 wiki 标记或 Markdown 渲染为字面字符(如 h1.、text、# Heading)。/rhdh-jira-api 负责 wiki→ADF 转换;不要用 Markdown 段落手工构建 ADF。

与相邻技能的边界

  • 运行访谈并创建 issue 是 /rhdh-jira-create。
  • 审计已存在的 issue 是 /rhdh-jira-refine。
  • 字段 ID、组件目录、JQL、acli 语法和工作流退出标准是 /rhdh-jira-api。
  • 通用访谈节奏是外部 grilling 技能,按名称调用。这里只包含 RHDH 特有的部分。

完成条件

当用户直接调用本技能,且结果是一份可供其使用的完整草稿时,在返回前对填写好的摘要和描述调用一次 /prose-editing,使用相应语域。保留 Jira wiki 标记、模板标题、字段值、issue key、链接和验收标准。当 /rhdh-jira-create 或 /rhdh-jira-refine 调用本技能时,直接交回撰写结果而不编辑;由最终调用方负责唯一一次文字润色。

完成标准:草稿指明其模板和 issue 类型;模板要求的每个部分要么已填写,要么明确标记为超出范围;挑战矩阵中每个适用的挑战都已应用,或已跳过并说明理由;提议的规模引用其来源尺度,而非凭感觉。重复项检查报告其运行的查询及看到的行数。任何草稿在用户未看到之前都不算完成。