上下文菜单
在 Azure Boards 或 Queries 中，打开工作项菜单 → Raaghu，即可在不离开看板的情况下运行 AI 操作：对话、审查就绪度、改进描述或验收标准、生成子项与测试用例、从笔记构建 backlog，或评估影响。
你需要 Raaghu Spec Kit 席位并已连接 AI 提供商。参见 安装。若看不到 Settings，请让管理员连接 AI（Settings）。更想用引导式工作区卡片？请使用 Workflows。
打开上下文菜单
- 在 backlog、看板或查询结果中，打开工作项上下文菜单（右键或 …）。
- 选择 Raaghu。
- 选择一项操作。Raaghu Spec Kit 会为该工作项打开侧栏面板。
操作
| 操作 | 作用 |
|---|---|
| Open Chat | 打开面板以便提问。在你保存草稿或创建工作项之前，不会写入 Azure DevOps。 |
| Review Work Item | 只读就绪度报告（摘要、缺口、风险、结论、下一步）。可选 Apply fixes as draft。 |
| INVEST Check | 用 INVEST 检查清单（Independent、Negotiable、Valuable、Estimable、Small、Testable）为工作项打分，并适配 Epic、Feature、User Story 等类型。可选将优先修复应用到草稿，或在工作项上标记分数。 |
| Improve Description | 在可审阅草稿中改写措辞与结构。保留原意，不编造新范围。也可改进标题。 |
| Generate Acceptance Criteria | 在保留现有描述的前提下起草可测试的验收标准。审阅后 Save changes。 |
| Generate Child Items | 按流程模板建议下一层级子项。编辑、创建或跳过每张卡片。 |
| Generate Test Cases | 建议 Gherkin（Given/When/Then）或分步测试用例。审阅后在 Azure DevOps 中创建关联的 Test Cases。 |
| Backlog from Notes | 粘贴或上传笔记（.txt / .md，最多 8000 字符）。Raaghu Spec Kit 会预览子项类型，然后你可点击 Generate backlog items 审阅并创建。 |
| Assess Impact | 描述要评估的变更（Change Request 类型可选）。返回影响报告；关联的父项、子项及相关项仅作上下文——不会自动标记为受影响。 |
批量： 多选工作项时，Review Work Item、INVEST Check 与 Generate Acceptance Criteria 可对所选集合运行。其他操作作用于主选中项。
哪种操作适合哪种工作项？
Raaghu 菜单会在每种工作项上显示这些操作。用下表选择最合适的用法。Raaghu Spec Kit 会按类型调整提示；仅部分子项操作无法在 Task 上运行。
| 操作 | Epic | Feature | User Story / PBI | Task | Bug |
|---|---|---|---|---|---|
| Review Work Item | 最适合 | 最适合 | 最适合 | 也可用 | 最适合 |
| INVEST Check | 也可用 | 也可用 | 最适合 | 也可用 | 也可用 |
| Improve Description | 最适合 | 最适合 | 最适合 | 也可用 | 最适合 |
| Generate Acceptance Criteria | 也可用 | 也可用 | 最适合 | 建议跳过 | 最适合 |
| Generate Child Items | 最适合 → Features | 最适合 → Stories | 最适合 → Tasks | 不支持 | 也可用 → Tasks |
| Generate Test Cases | 也可用* | 也可用 | 最适合 | 建议跳过 | 最适合 |
| Backlog from Notes | 最适合 | 最适合 | 也可用 | 不支持 | 也可用 |
| Assess Impact | 最适合 | 最适合 | 最适合 | 也可用 | 最适合 |
*在 Epic 上生成的测试用例偏高层。Raaghu Spec Kit 会提示警告，然后继续。
| 标签 | 含义 |
|---|---|
| 最适合 | 该工作项类型优先使用 |
| 也可用 | 可运行且可用，但通常不是最佳选择 |
| 建议跳过 | 对该类型通常帮助不大 |
| 不支持 | Raaghu Spec Kit 会阻止该操作（Task 不能有子项） |
工作项面板
面板显示当前工作项（类型与状态）、快捷操作芯片与对话。Refine 类操作会打开带 Preview / Edit / Diff 的草稿。确认前不会保存到 Azure DevOps。
Recommended by Raaghu 仅在存在具体缺口时出现——例如描述过薄，或验收标准缺失/偏弱。工作项看起来已就绪时，不显示推荐卡片。你运行某项操作 后，该操作会排除在推荐之外，直到开始 New conversation。若仍有缺口，快捷操作 chip 仍可显示 Suggested 徽章。
Backlog from Notes
- 从上下文菜单（或面板中的快捷操作）选择 Backlog from Notes。
- 粘贴笔记或上传
.txt/.md文件（最多 8000 字符）。面板会显示将在父项下创建的子项类型。 - 点击 Generate backlog items，然后审阅每张建议卡片——编辑、Create 或 Skip。
Assess Impact
- 从上下文菜单（或面板中的快捷操作）选择 Assess Impact。
- 输入要评估的变更（大多数工作项类型必填；Change Request 可选）。关联项仅作上下文。
- 点击 Start Assess Impact，审阅报告（直接受影响、可能受影响、级联风险与建议操作）。
Generate Acceptance Criteria
- 从上下文菜单（或面板中的快捷操作）选择 Generate Acceptance Criteria。
- 审阅拟议的验收标准草稿（描述保持不变）。
- 按需编辑，然后 Save changes 写回工作项。
Generate Test Cases 或 Child Items
- 运行 Generate Test Cases 或 Generate Child Items。
- 审阅每张建议卡片——编辑标题/正文，Create、Skip，或撤销跳过。
- 对于 Generate Child Items，当子项类型为 Task 时，每张卡片还有可编辑的 Remaining work (h)。Features、故事与测试用例不显示该字段。
- 已创建项会在 Azure DevOps 中打开；列表完成后面板会关闭，除非你继续操作。
