跳到主要内容
版本:v3.0.0

初始化 Raaghu Spec Kit

在生成规范、计划和任务之前,必须为项目初始化 Raaghu Spec Kit。初始化会在项目 Wiki 中设置 Raaghu Spec Kit 文件。每个项目只需做一次。

前提条件​

  • 完成 安装与启动、使用 Microsoft 授权,并拥有席位
  • 项目 Wiki(如需要,扩展会自动创建)
  • 对 GitHub.com 的出站 HTTPS 访问(模板从开源 GitHub Spec Kit 仓库获取)

初始化会做什么​

初始化在浏览器中运行(无需构建流水线或代理)。它会:

  1. 运行预检 — 确认 GitHub 访问,并查找或创建项目 Wiki。
  2. 检查 Raaghu Spec Kit 是否已初始化。
  3. 从 GitHub 获取 GitHub Spec Kit 模板、命令定义和脚本。
  4. 在 Wiki 中创建 Speckit 根页面。
  5. 将获取的文件写入 Speckit/ 下。

你会看到进度消息,例如 "Running pre-flight checks…"、"Fetching Speckit files from GitHub…"、"Writing file X/Y…",最后是 "Initialization complete!"。

步骤​

  1. 打开 Raaghu Spec Kit。若尚未初始化 Raaghu Spec Kit,右侧面板会显示 Initialize Raaghu Spec Kit。
  2. 点击 Initialize Raaghu Spec Kit。
  3. 等待 "Initialization complete!"。

右侧 Initialize Raaghu Spec Kit 面板,Dashboard 指标为空右侧 Initialize Raaghu Spec Kit 面板,Dashboard 指标为空

完成后,聊天面板会打开,Dashboard 变为可用。

初始化后的工作区初始化后的工作区

Wiki 中会创建什么​

Speckit/
├── specify/ ← 引擎文件、memory、模板
│ ├── memory/ ← 项目 constitution 保存在此
│ ├── scripts/
│ └── templates/
└── devops/ ← 命令定义

后续命令会添加如 specs/(每个功能一个文件夹)和 intake/ 等文件夹。通常无需手动编辑这些引擎文件夹。

Azure DevOps Wiki 页面不带 .md 扩展名。诸如 specs/001-feature-name/spec 的路径对应名为 spec 的 Wiki 页面。

项目 Wiki 中的 Speckit 目录树项目 Wiki 中的 Speckit 目录树

重新初始化​

若 Raaghu Spec Kit 已存在且再次初始化,系统会在覆盖前提示确认。选择 Yes, Update 或 Cancel。

重新初始化仅用于恢复。不必每次打开项目都初始化。

常见错误​

消息处理方式
"GitHub API rate limit reached…"等待几分钟后重试
"Cannot reach GitHub to fetch Speckit files…"检查对 GitHub.com 的网络或防火墙访问,然后重试
"Could not create the project wiki automatically…"打开项目中的 Wiki 选项卡,创建项目 Wiki,然后再次初始化

另见 故障排除。

下一步​