rhdh-jira-authoring

RHDH Jira 编写

决定一个问题在六个月后是否仍值得阅读的材料。 两个技能会用到它——起草时的 /rhdh-jira-create 和审核时的 /rhdh-jira-refine——因此它放在这里，而不属于其中任何一个技能。

此技能会生成文本并作出判断。它不会运行 Jira 命令，也不会执行任何写入操作。

按需求查找

需求	加载内容
如何质疑草稿；如何从对话中推断 RHDH Jira 字段	references/grill.md
T-shirt 尺寸、故事点数、RHDHSUPP 工作量点数、尺寸评估质疑	references/sizing.md
这项内容是否已经存在？	references/duplicates.md
将 Feature 拆分为 Epic，或将 Epic 拆分为 Story	references/work-breakdown.md

模板与示例

描述模板采用 Jira wiki 标记语言。每个模板旁边都有一个填好的示例，用于校准语气和细节——起草前请先阅读示例，因为仅凭模板无法充分说明 RHDH 审核者期望的细节程度。

问题类型	常用项目	模板	示例
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 中项目自己的模板起草。

子任务是现有问题的子项，绝不能独立存在。

填好的模板采用 wiki 标记语言；如果直接将这些字符塞入 ADF 文本节点而未进行转换，Jira Cloud 会将 wiki 标记语言或 Markdown 按原样显示为字符（h1.、*text*、# Heading）。/rhdh-jira-api 负责 wiki→ADF 转换；不要根据 Markdown 段落手动构建 ADF。

与相邻技能的边界

• 进行访谈并创建问题由 /rhdh-jira-create 负责。
• 审核已存在的问题由 /rhdh-jira-refine 负责。
• 字段 ID、组件目录、JQL、acli 语法和工作流退出条件由 /rhdh-jira-api 负责。
• 通用访谈节奏由外部 grilling 技能负责，按名称调用即可。这里仅包含 RHDH 专属部分。

完成标准

当有人直接调用此技能，且结果是一份可供使用的完整草稿时，在返回草稿前，请对已填写的摘要和描述以轻松自然的语体调用一次 /prose-editing。保留 Jira wiki 标记语言、模板标题、字段值、问题键、链接和验收标准。当 /rhdh-jira-create 或 /rhdh-jira-refine 调用此技能时，请直接返回编写结果，不要编辑；由最终调用方负责唯一一次文字润色。

只有在草稿注明所用模板和问题类型、模板要求的每个部分都已填写或明确标记为不在范围内、矩阵中每项适用的质疑都已提出或说明跳过原因，且建议的尺寸注明了所依据的量表而非主观感受时，才算完成。重复项检查需报告运行的查询和看到的行数。凡是用户还没看过草稿的情况，都不能算完成。