可视化
Visual 选项卡以连接树的形式展示工作项层级。在此可从 Raaghu Spec Kit 文件 Sync Azure Boards 工作项（一次一个层级）、查 找并将现有 Boards 工作项自动链接进 Raaghu Spec Kit 树、用 AI 优化工作项，并浏览关联。
若尚未初始化 Raaghu Spec Kit，右侧面板仍会显示 Initialize Raaghu Spec Kit。初始化完成后、但尚无 Epic 或 Feature 可显示时，Visual 可能显示 "No work items found"，并提供 + Start a New Spec Session：
生成规范并同步工作项后，层级画布如下所示：
层级结构
flowchart LR
C["Constitution"] --> E["Epic"]
E --> F["Feature"]
F --> U["User Story"]
U --> T["Task"]
Constitution 节点是来自 Raaghu Spec Kit constitution 的锚点——它不是 Azure Boards 工作项。Epic、Feature、User Story 和 Task 是 Boards 工作项。类型名称遵循你的过程模板（例如用 "Issue" 代替 "Feature"）。
每张卡片显示类型、ID、状态、标题、子项计数，以及魔法棒按钮。点击标题可在 Azure DevOps 中打开该工作项。
工作项在属于 Raaghu Spec Kit、带有 raaghuspeckit-autolinked 标签，或与真实 wiki spec.md / tasks.md 重叠时，会保留在主 Raaghu Spec Kit 树上。未匹配的 Boards 工作项在运行图表 Sync 后出现在孤立项图中。
同步与优化（魔法棒）
打开卡片的魔法棒菜单：
| Sync 来源 | 创建 | Wiki 中需要 |
|---|---|---|
| Constitution | Epics | 已保留的 constitution |
| Epic | Features | 至少一个功能 spec |
| Feature | User Stories | 功能 spec |
| User Story | Tasks | 功能 tasks |
请按层级操作。Sync 会将 Raaghu Spec Kit 文 件与现有工作项对比并创建或更新——不会创建重复项。同步某一层级不会自动创建所有更深层的子项。
Refine 会在聊天中打开该工作项，以便用 AI 改进。
若 Sync 不可用，请先用 Raaghu Spec Kit 命令 生成所需文件。
图表 Sync（查找并自动链接）
Visual 图表叠加层上有一个控件（与从 wiki 文件创建工作项的魔法棒 Sync | … 操作分开）：
| 控件 | 标签 | 作用 |
|---|---|---|
| 图表 Sync | Sync / Syncing… | 查找 Raaghu Spec Kit 层级之外的工作项，然后将匹配项自动链接进树 |
图表 Sync 会先发现孤立项（提示标题仍可能显示 Scan complete），然后运行自动链接。自动链接需要已初始化 Raaghu Spec Kit（存在 constitution）并已配置 AI 提供方。未配置 AI 时可能看到 Auto-link skipped — Configure an AI provider to auto-link work items. 未初始化 Raaghu Spec Kit 时，自动链接会跳过，直到完成初始化。
链接成功时可能显示 Auto-link complete（例如 Linked N work item(s) into the Raaghu Spec Kit hierarchy.）。已链接卡片可显示绿色勾选（connected to the project hierarchy）。Raaghu Spec Kit 会在匹配项上标记 raaghuspeckit-autolinked 标签。
Spec 缺口（spec gaps）
当已链接的 brownfield 工作项描述落后于对应 wiki 内容时，卡片会显示琥珀色警告（spec gaps detected）。将鼠标悬停在警告上可查看匹配来源（例如 Matched to spec …）、Description is behind the spec.、缺失部分（例如 Missing Overview），以及 Click the wand → Refine to update from the spec。
使用魔法棒 → Refine，审阅草稿（Preview / Edit / Diff），然后继续根据 constitution / spec.md / tasks.md 更新工作项。
Wiki 中的 Related work
图表 Sync 的自动链接与缺口 Refine 可在匹配的 wiki 页面（constitution 或功能 spec）上添加 Related work 部分，列出已链接的 Boards 工作项，并可在工作项上添加 wiki 超链接。打开 Raaghu Spec Kit/（或较旧项目的 Speckit/）下的 wiki 页面即可查看。
浏览画布
- 使用计数徽章展开或折叠分支。
- 在工具栏中按类型筛选，并按标题搜索。
- 平移和缩放画布。