Raaghu Spec Kit 命令
Raaghu Spec Kit 命令会生成结构化内容,并保存到项目 Wiki 的 Speckit/ 下。可从 聊天面板 的 Command 下拉菜单运行,或直接输入命令。
开始之前: 在 Settings 中连接 AI 提供商,并 初始化 Raaghu Spec Kit。


命令一览
| 命令 | 用途 | 保存位置(Wiki) |
|---|---|---|
/speckit.constitution | 定义项目原则与护栏 | Speckit/specify/memory/constitution |
/speckit.specify | 构建包含需求与验收标准的功能规范 | Speckit/specs/NNN-feature-name/spec |
/speckit.clarify | 检测歧义、提问并更新规范 | 更新功能的 spec |
/speckit.plan | 创建技术实现计划 | Speckit/specs/NNN-feature-name/plan |
/speckit.tasks | 将计划拆分为分阶段任务列表 | Speckit/specs/NNN-feature-name/tasks |
/speckit.analyze | 交叉检查 spec、plan、tasks 与 constitution 的缺口 | 在聊天中生成报告 |
/speckit.checklist | 生成需求质量检查清单 | Speckit/specs/NNN-feature-name/checklists/… |
/speckit.converge | 代码推送后,将仓库与 spec/plan/tasks 对比并追加剩余任务 | 追加到 tasks |
在 Settings → Commands Mapping 中,可在 Default(友好名称)与 Raaghu Spec Kit(speckit.* ID)之间切换。例如:"Create Specification" 等同于 /speckit.specify。
推荐顺 序
按此顺序运行命令。constitution 每个项目设置一次;其余命令按每个功能运行。
| 顺序 | 命令 | 是否必需 | 说明 |
|---|---|---|---|
| 1 | /speckit.constitution | 是(一次) | 设定项目原则 |
| 2 | /speckit.specify | 是 | 定义要构建的内容 |
| 3 | /speckit.clarify | 建议 | 在规划前澄清未充分说明的部分 |
| 4 | /speckit.plan | 是 | 定义技术栈与实现计划 |
| 5 | /speckit.tasks | 是 | 生成任务列表 |
| 6 | /speckit.analyze | 可选 | 一致性与覆盖度分析 |
| 7 | /speckit.checklist | 可选 | 需求质量检查清单 |
| 8 | /speckit.converge | 可选(推送后) | 对照规范核对代码 |
CREATE 与 UPDATE
大多数命令是增量式的:
- CREATE — 当前功能尚无对应文件时,命令会从模板生成。
- UPDATE — 文件已存在时,命令会追加新内容并保留已有内容。
示例
/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements
/speckit.specify Build an app to organize photos into date-grouped albums, with drag-and-drop reordering and a tile preview inside each album.
/speckit.clarify
/speckit.plan Use Vite with minimal libraries. Prefer vanilla HTML, CSS, and JavaScript. Store metadata in a local SQLite database.
/speckit.tasks
命令运行后,请查看预览并选择 Keep 或 Regenerate。
/speckit.constitution
设定项目原则(每个项目一次)。预览草稿后选择 Keep。


/speckit.specify
在 Speckit/specs/NNN-feature-name/ 下创建功能 spec(以及 requirements 等相关页面)。


/speckit.clarify
在聊天中提出澄清问题(通常带有 Optimal 建议)。回答这些问题,以便将缺口回写到规范中。


/speckit.plan
生成实现计划及相关文件(plan、research、data-model 等)。


/speckit.checklist
在功能的 checklists/ 文件夹下创建需求质量检查清单。


/speckit.tasks
将计划拆分为分阶段的 tasks 列表。


/speckit.analyze
交叉检查 spec、plan、tasks 与 constitution。结果以分析报告形式出现在聊天中(缺口、严重程度与建议)。


工作流与命令
- 命令(
/speckit.*)是你从聊天中直接运行的操作。 - Workflows 是 Workflows 选项卡中的引导式多步对话,使用同一引擎。
完整演练请参见 你的第一个功能。