跳到主要内容
版本：v3.3.2

需求收录

Intake 选项卡用于将需求文档（BRD、PRD 等）引入项目。AI 会分析每份文档，并帮助你创建 Azure Boards 工作项。

文档存储在 Wiki 的 Raaghu Spec Kit/intake/ 下（较旧项目为 Speckit/intake/）。

前提条件： Raaghu Spec Kit 必须已 初始化，且 AI 提供商必须已连接。若未初始化 Raaghu Spec Kit，会显示 "Raaghu Spec Kit Required"。若未配置 AI 提供商，会显示 "LLM required" 或 "LLM is not configured"（LLM 指 AI 模型或连接）。组织管理员和 Project Administrators 在 Settings 中连接 AI。若看不到 Settings，请让管理员为本项目连接 AI。

Intake 选项卡空状态：No Intake Documents yetIntake 选项卡空状态：No Intake Documents yet

添加文档​

  1. 点击 + New Intake。
  2. 从 Repos、Wiki、Boards、Backlogs 及其他 Azure DevOps 来源选择文件，或 Upload from computer。
  3. 一次最多选择 4 个文件，然后点击 Add to intake。

支持的类型包括用于 AI 分析的 .md、.txt、.docx、.pdf 及常见文本格式，以及用于工作项导入的电子表格（.xlsx、.xls、.csv）。基于文本的需求文档最适合分析。

请分别上传电子表格与需求文档。电子表格走工作项导入；其他文件走 AI 分析。同一次上传中混用两者不受支持。

大型文档会按重叠分块进行分析（待办规划也可按标题或章节拆分），再合并为一次分析结果。若文档非常大，可能只分析到部分内容——结果会注明分析被截断。尽量将关键需求放在文件靠前位置。

对于需求文档，扩展会将副本保存到 Wiki，运行 AI 分析，完成后显示 "Intake analysis complete"。

空状态显示 "No Intake Documents yet"。点击该空状态上的 New Intake（或工具栏中的 + New Intake）即可添加文件。

Intake 空状态与 New Intake 按钮Intake 空状态与 New Intake 按钮

停止或重试分析​

Intake 分析进行中时，可在聊天页脚使用 Stop generating 取消。停止或中断后，回复可能显示 "Response stopped…" — 点击 Retry 可再次运行分析，无需重新选择相同文件（本地上传会保留已提取内容以便重试）。

阅读分析结果​

每份文档以卡片形式显示。展开后可查看：

  • AI Analysis Summary — 文档的简短描述
  • Document Understanding — 计数项：
类别含义
Business Goals高层目标
User Roles用户类型 / 角色画像
Functional Requirements系统必须完成的功能
Non-Functional Requirements性能、安全等
Risks / Assumptions未关闭风险（在聊天中审阅）
Open Questions未解决问题（在聊天中审阅）

聊天还可能提出澄清问题（例如在 Scope 下），以便在创建工作项前消除歧义。问题一次显示一个（Back / Next，最后一题为 Submit Answer）。

分析后的 Intake 文档，含 Document Understanding 卡片分析后的 Intake 文档，含 Document Understanding 卡片

创建工作项（来自分析）​

分析完成后，聊天会建议 Azure Boards 工作项（卡片标记为 Recommended）：

  1. 对每条建议选择 Create 或 Skip。
  2. 可先编辑 Title、Description 和 Acceptance criteria。
  3. 创建时可选择 Team 与 Sprint（与 聊天 相同）。然后工作项会在 Azure Boards 中创建，并关联回源文档。
  4. 也可使用 Create all (N) 一次创建全部待处理建议。运行时按钮显示 Creating current/total…，列表不会随每项完成而跳动。

若你 Skip 某条建议，可在流程中使用 Show skipped (N)（或 Hide skipped）查看已跳过的卡片。每行显示 Skipped 徽章和 Undo skip，以便恢复建议并再次 Create。

Intake 流程中已跳过建议与 Undo skipIntake 流程中已跳过建议与 Undo skip

已创建和已修改的工作项会显示在文档卡片上。软删除到 Azure DevOps Recycle Bin 的工作项会显示在 Deleted 下，而不是 Created。

电子表格导入​

添加电子表格（.xlsx、.xls 或 .csv）时，Intake 会映射列并预览行，而不是运行完整的 AI 分析流程。

  1. 查看已映射列与预览行（Valid / Invalid）。
  2. 可从建议卡片逐条创建，或使用 Create all (N) 创建所有待处理的有效行。
  3. 创建进行中时，每行状态会变为 Creating，随后为 Created（含新工作项 id）或 Skipped。进度可能显示为 Creating 2/5…。

下一步​