快速入门
约 10 分钟内从零开始完成可用的 Raaghu Spec Kit 会话。
若组织尚未订阅或分配席位,组织管理员须先完成 管理员设置。成员随后可按下列步骤操作。
前提条件
- 一个 Azure DevOps 组织与项目
- 安装 Marketplace 扩展的权限(或已由管理员安装 Raaghu Spec Kit)
- Raaghu Spec Kit 订阅上的席位(由管理员分配)
步骤
1. 安装并打开
- 若尚未安装,从 Visual Studio Marketplace 安装 Raaghu Spec Kit。
- 打开项目 → 左侧边栏 → Raaghu Spec Kit。
详情:安装与启动。
2. 使用 Microsoft 授权
- 在着陆页点击 Authorize Now(已分配席位的回访用户可能会跳过此步,并在 Raaghu Spec Kit 登录时看到短暂加载界面)。
- 完成 Microsoft 登录并批准访问。
- 若看到 "Request submitted. Retry authorization after admin approval",请管理员在 Organization settings → Extensions → Raaghu Spec Kit → Users → Pending requests 中批准你(访问请求),然后再次点击 Authorize Now。
3. 获取席位
Raaghu Spec Kit 按席位授权。批准待处理请求也会分配席位(Approve and assign seat?)。管理员之后仍可在 Users 子选项卡上 Assign / Unassign 席位。
- 管理员: Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → Users(批准待处理请求,或 Assign / Unassign 席位)。参见 Organization Settings。
- 成员: 请管理员批准你的请求或为你分配席位。在此之前,你可能会看到席位或订阅相关提示。
4. 初始化 Raaghu Spec Kit(每个项目一次)
- 若尚未设置 Raaghu Spec Kit,点击 Initialize Raaghu Spec Kit。
- 等待 "Initialization complete!"。
这会在项目 Wiki 中创建 Raaghu Spec Kit/ 目录树(较旧项目可能仍使用 Speckit/)。每个项目只需做一次。
5. 连接 AI
聊天和大多数 Raaghu Spec Kit 功能需要 AI 连接(产品中可能标为 LLM)。
若你是组织管理员或 Project Administrator
- 打开菜单(Raaghu Spec Kit 顶部)→ Settings(普通成员看不到此菜单项)。
- 在 LLM Settings 中选择本项目获取 AI 的方式:
| 情况 | 操作 |
|---|---|
| 管理员已为本项目配置好 AI | 在 LLM Settings 中保持 Project LLM 为 Off(若组织如此配置,也可开启 Raaghu AI) |
| 需要使用自己的提供商密钥 | 在 LLM Settings 中打开 Project LLM,添加 Azure OpenAI、OpenAI 或 Claude,保存并设为 Default |
| 聊天仍提示尚未配置 AI | 在 Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → AI Settings → Project 中允许 Use organization AI、Use project AI 或 Use Raaghu AI,或充值 Raaghu AI 额度 |
详情:Settings。
若你是普通团队成员
你不会在菜单中看到 Settings。请项目或组织管理员为本项目连接 AI。当聊天不再提示尚未配置 AI 时,继续下一步。
6. 继续完成你的第一个功能
AI 可用后:
首次进入工作区时可能出现简短产品导览。可以关闭——它是可选的。