快速入门
约 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 按席位授权。批准访问不等于分配席位。
- 管理员: Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → Users → Assign seat。参见 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——表示 AI 模型或连接)。
若你是组织管理员或 Project Administrator
- 打开汉堡菜单 → Settings(普通成员看不到此菜单项)。
- 在 LLM Settings 中选择本项目获取 AI 的方式:
| 情况 | 操作 |
|---|---|
| 管理员已为本项目分配组织 AI 连接或启用了 Raaghu AI | 保持 Project LLM 为 Off(若组织如此配置,则使用 Raaghu AI) |
| 需要使用自己的提供商密钥 | 打开 Project LLM,添加 Azure OpenAI、OpenAI 或 Claude,保存并设为 Default |
| 聊天仍显示 "LLM is not configured" | 在 Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → AI Settings 中允许 Use project AI 或 Use Raaghu AI,或充值 Raaghu AI 额度 |
详情:Settings。
若你是普通团队成员
你不会在汉堡菜单中看到 Settings。请项目或组织管理员为本项目连接 AI。当聊天不再显示 "LLM is not configured" 时,即可进入下一步。
6. 继续完成你的第一个功能
AI 可用后:
首次进入工作区时可能出现简短产品导览 。可以关闭——它是可选的。