快速入门
约 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 → Raaghu Spec Kit → Users → Pending requests 中批准你(访问请求),然后再次点击 Authorize Now。
3. 获取席位
Raaghu Spec Kit 按席位授权。批准访问不等于分配席位。
- 管理员: Azure DevOps → Organization settings → 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
- 打开汉堡菜单 → Settings。
- 在 Project Settings 中选择本项目获取 AI 的方式:
| 情况 | 操作 |
|---|---|
| 管理员已设置共享组织 AI 或 Raaghu-hosted AI | 保持选择 Admin |
| 需要使用自己的提供商密钥 | 选择 Custom,添加 Azure OpenAI、OpenAI 或 Claude,保存并设为 Default |
| 聊天仍显示 "LLM is not configured" | 请管理员设置组织 AI 默认值、启用 Raaghu-hosted AI,或确认你应使用 Custom |
详情:Settings。
6. 继续完成你的第一个功能
前往 你的第一个功能,运行完整命令序列并将工作项同步到 Azure Boards。
首次进入工作区时可能出现简短产品导览。可以关闭——它是可选的。