初始化 Raaghu Spec Kit

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

前提条件

• 完成 安装与启动、使用 Microsoft 授权，并拥有席位
• 项目 Wiki（如需要，扩展会自动创建）。若项目没有 wiki，右侧面板会显示 Initialize Raaghu Spec Kit
• 对 GitHub.com 的出站 HTTPS 访问（模板从开源 GitHub Spec Kit 仓库获取）

初始化会做什么

初始化在浏览器中运行（无需构建流水线或代理）。它会：

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

你会看到进度消息，例如 "Running pre-flight checks…"、"Fetching Speckit files from GitHub…"、"Creating Raaghu Spec Kit wiki structure…"、"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!"。

初始化进行期间会显示 hub splash，依次为 Welcome → Why Use Raaghu Spec Kit? → Journey。完成后，All Set 卡片提供前往 Intake、Workflows 与 Dashboard 的快捷入口，随后聊天面板打开，工作区即可使用。

Wiki 中会创建什么

新项目使用 Raaghu Spec Kit 根路径。此版本之前初始化的较旧项目仍使用 Speckit。任一根路径下的文件夹布局相同：

Raaghu Spec Kit/          (or Speckit/ on older projects)
├── specify/              ← 引擎文件、memory、模板
│   ├── memory/           ← 项目 constitution 保存在此
│   ├── scripts/
│   └── templates/
└── devops/               ← 命令定义

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

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

重新初始化

若 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，然后再次初始化

另见 故障排除。

下一步

• Settings — 连接 AI 提供商
• 你的第一个功能
• 聊天面板