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

你的第一个功能

为一个功能运行核心 Raaghu Spec Kit 命令序列，在 Azure Boards 中同步 Epic → Feature → User Story → Task 层级，并验证 Wiki 工件。

时间：首次约 20–30 分钟。

前提条件​

  • 已完成 快速入门（已授权、已分配席位、已初始化、已连接 AI）
  • 右侧可见聊天面板

本教程使用 /speckit.* 命令。若 Settings → Commands Mapping 设为 Default，下拉菜单会显示友好名称（例如 "Create Specification" 而非 /speckit.specify）。这些是同一组命令。

更想用引导式卡片而不是斜杠命令？从 Workflows 开始 — 同一引擎，更少需要记住的命令。想走完整命令序列时再用本教程。

步骤 1：设定 constitution（每个项目一次）​

/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements

查看预览，然后点击 Keep（或点击 Regenerate 生成另一份草稿）。constitution 保存在 Wiki 的 Raaghu Spec Kit/specify/memory/constitution（较旧项目也可能在 Speckit/ 下）。

步骤 2：指定功能（Specify）​

描述要构建什么（暂不涉及技术栈）：

/speckit.specify Build an app to organize photos into date-grouped albums, with drag-and-drop reordering and a tile preview inside each album.

会在 Raaghu Spec Kit/specs/NNN-feature-name/ 下创建新的功能文件夹，并包含 spec 页面（较旧项目也可能在 Speckit/ 下）。

步骤 3：澄清歧义（Clarify）​

/speckit.clarify

回答 AI 在聊天中提出的问题，以便将缺口回写到规范中。

步骤 4：规划并拆分任务（Plan & Tasks）​

/speckit.plan Use Vite with minimal libraries. Prefer vanilla HTML, CSS, and JavaScript. Store metadata in a local SQLite database.
/speckit.tasks

这会在同一功能文件夹下创建 plan 和 tasks。

步骤 5：创建并同步工作项（Visuals）​

打开 Visuals 选项卡，用卡片魔法棒一次同步一个层级（不要用蓝色图表 Sync 按钮）：

  1. 在 Constitution 卡片上，打开魔法棒菜单并同步 Epics。
  2. 在 Epic 卡片上，同步 Features。
  3. 在 Feature 卡片上，同步 User Stories。
  4. 在 User Story 卡片上，同步 Tasks。

若 Sync 不可用，请先生成所需的 Wiki 文件（Epic 需要 constitution；Feature 需要功能 spec；Task 需要 tasks）。详情：Visuals。

确认画布上出现 Epic → Feature → User Story → Task 树。再次运行 Sync 会更新现有工作项，而不会重复创建。

步骤 6：验证 Wiki​

  1. 打开 Azure DevOps Wiki。
  2. 浏览 Raaghu Spec Kit/specs/NNN-feature-name/（或 Speckit/…），确认存在 spec、plan 和 tasks。

可选后续命令​

  • /speckit.analyze — 一致性与覆盖度缺口
  • /speckit.checklist — 需求质量检查清单
  • /speckit.converge — 代码推送后，追加剩余任务

你也可以尝试 Workflows 能力（例如 Project Setup → Create project foundation）。目录：Workflows。

下一步​