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

管理员设置

若你是组织管理员，请使用本清单。你将安装 Raaghu Spec Kit、订阅、审批用户、分配席位，并设置组织级 AI 默认值，以便团队开展工作。

前提条件​

  • Azure DevOps 组织管理员权限
  • 能够安装 Marketplace 扩展
  • Stripe 结账的账单访问权限（订阅与额度），或发放给组织的许可证密钥

仅管理员可执行的操作​

任务位置
安装扩展Visual Studio Marketplace — Raaghu Spec Kit
启动试用、订阅、激活许可证密钥、调整席位、充值 Raaghu AI credits、管理账单Azure DevOps → Organization settings → Raaghu Spec Kit
批准或拒绝首次用户Organization settings → Raaghu Spec Kit → Users → Pending requests
分配或取消席位Organization settings → Raaghu Spec Kit → Users → Assigned users / Available to assign
设置组织 LLM 连接与按项目的 AI 权限Organization settings → Raaghu Spec Kit → Configurations
启用项目的 Raaghu AI / 项目 LLM（在组织权限允许后）Raaghu Spec Kit 汉堡菜单 → Settings → LLM Settings（组织管理员与 Project Administrators）

成员仅在访问获批（如需要）并且被分配席位后，才能授权并使用中心。

步骤​

1. 安装扩展​

  1. 打开 Visual Studio Marketplace 上的 Raaghu Spec Kit 扩展页。
  2. 点击 Get → 选择组织 → Install。
  3. 在 Organization settings → Extensions → Installed 中确认。

详情：安装与启动。

2. 打开计费中心​

  1. 在 Azure DevOps 中打开 Organization settings。
  2. 在左侧菜单中选择 Raaghu Spec Kit。

你应看到选项卡：Subscription、Users、Configurations、License Keys 和 Raaghu AI Credits。

此中心与扩展内的 Settings 对话框（汉堡菜单）是分开的；组织管理员与 Project Administrators 用它管理项目 LLM 密钥、当前项目的 Raaghu AI 以及命令标签。组织级连接位于 Configurations。详情：Organization Settings。

3. 启动试用、订阅或激活许可证密钥​

在计费中心选择以下任一路径：

  1. 免费试用（建议新组织使用）： 在 Subscription 上，符合资格的租户管理员会看到 Choose Your Plan。选择 Free Trial，然后点击 Start Free Trial（up to 5 seats，no credit card required）。确认方案徽章显示 Free trial，且 Trial summary 列出 Trial ends on。
  2. 付费订阅： 在 Choose Your Plan 上选择 Paid，设置席位数，点击 Subscribe Now（或当试用不可用时使用 Subscribe for $…/month），并完成结账（Professional Plan — 每席位每月 $9）。如果您有促销码，请在 Stripe 结账页面输入。确认状态显示为 Active。
  3. 许可证密钥： 在 License Keys 中输入密钥（RAAGHU-XXXX-XXXX-XXXX），预览后点击 Confirm & activate。之后 Subscription 会显示 License key 徽章和 Expires on。

试用结束后，可通过付费结账或许可证密钥继续使用。若看不到 Choose Your Plan / Start Free Trial，说明组织不符合试用资格 — 请改用付费结账或许可证密钥。

详情参见 Organization Settings。

4. 审批访问请求​

  1. 用户首次授权时，可能会提交访问请求。
  2. 打开 Organization settings → Raaghu Spec Kit → Users → Pending requests。
  3. 对每条请求选择 Approve 或 Reject（或选择多条后使用 Approve selected）。

详情：访问请求。

5. 分配席位​

  1. 留在 Organization settings → Raaghu Spec Kit → Users。
  2. 打开 Available to assign，为每位应使用 Raaghu Spec Kit 的人员点击 Assign seat。
  3. 若你本人也要使用中心，请为自己分配席位。

重要： 仅批准不够——用户还需要已分配的席位。

6. 连接 AI（可选但建议）​

聊天和 Workflows 运行前，团队至少需要一种 AI 来源。可使用以下一种或多种方式：

  1. 组织密钥 — 在 Configurations → Organization 点击 + Add LLM，添加共享的 Azure OpenAI、OpenAI 或 Claude 连接。在 Configurations → Project 打开项目，开启 Use Organization Key，并在 Assign AI Services 下分配连接。
  2. 项目密钥 — 在 Configurations → Project 打开项目并开启 Use Project Key。项目管理员随后可在汉堡菜单 → Settings → LLM Settings 中添加密钥。
  3. Raaghu AI — 在 Configurations → Project 开启 Use Raaghu AI。若使用托管模型，请从 Subscription 或 Raaghu AI Credits 添加额度。用户随后在 Settings → LLM Settings 启用 Raaghu AI。可选支出上限在 Raaghu AI Credits 中设置。

Azure DevOps Organization settings → Raaghu Spec Kit 用于计费、席位与组织级 Configurations。扩展内 Settings 对话框用于当前项目的 LLM 开关、Raaghu AI 与 Commands Mapping。

7. 在项目中冒烟测试​

  1. 打开项目 → Raaghu Spec Kit。
  2. 初始化 Raaghu Spec Kit 一次。
  3. 确认聊天可以发送消息（AI 已连接）。
  4. 可选：运行 你的第一个功能。

下一步​