Raaghu Spec Kit 命令

Raaghu Spec Kit 命令会生成结构化内容，并保存到项目 Wiki 的 Raaghu Spec Kit/ 下（较旧项目可能仍使用 Speckit/）。可从 聊天面板 的 Command 下拉菜单运行，或直接输入命令。

开始之前： 在 Settings 中连接 AI 提供商，并 初始化 Raaghu Spec Kit。

命令帮助（ⓘ）

打开 Command 下拉菜单选择 Raaghu Spec Kit 命令。使用 ⓘ 按钮查看产品内帮助：

• Command 标题旁 — 打开 How to use commands（选择命令、添加简短描述、按 Enter），并提供示例
• 每个命令旁 — 打开包含 Description、What to enter 与 Example 的弹出层

命令一览

命令	用途	保存位置（Wiki）
/speckit.constitution	定义项目原则与护栏	Raaghu Spec Kit/specify/memory/constitution
/speckit.specify	构建包含需求与验收标准的功能规范	Raaghu Spec Kit/specs/NNN-feature-name/spec
/speckit.clarify	检测歧义、提问并更新规范	更新功能的 spec
/speckit.plan	创建技术实现计划	Raaghu Spec Kit/specs/NNN-feature-name/plan
/speckit.tasks	将计划拆分为分阶段任务列表	Raaghu Spec Kit/specs/NNN-feature-name/tasks
/speckit.analyze	交叉检查 spec、plan、tasks 与 constitution 的缺口	在聊天中生成报告
/speckit.checklist	生成需求质量检查清单	Raaghu Spec Kit/specs/NNN-feature-name/checklists/…
/speckit.converge	代码推送后，将仓库与 spec/plan/tasks 对比并追加剩余任务	追加到 tasks

在 Settings → Commands Mapping 中，可在 Default（友好名称）与 Raaghu Spec Kit（speckit.* ID）之间切换。例如："Create Specification" 等同于 /speckit.specify。

Idea Assessment 命令

在运行 /speckit.specify 之前评估想法。优先使用 Idea Assessment 中的引导界面（Workflows → Idea Assessment → + New Assessment）。以下斜杠命令供进阶用户使用，阶段相同。

命令	用途	保存到 (Wiki)
/speckit.assess.intake	原样记录想法，不做评判	Raaghu Spec Kit/specify/assessments/<idea-id>/intake
/speckit.assess.research	收集支持与反对的证据	…/assessments/<idea-id>/research
/speckit.assess.define	定义问题：受影响对象、目标、指标	…/assessments/<idea-id>/problem
/speckit.assess.shape	形成 2–3 个概念方案及权衡	…/assessments/<idea-id>/concept
/speckit.assess.decide	Go / Needs Clarification / Kill 结论	…/assessments/<idea-id>/decision
/speckit.assess.refine	Needs Clarification 后的 refinement（通常由引导流程驱动）	更新指定的 assessment 页面

可选的 slug=短想法id 可将各阶段保存在同一 wiki 文件夹（例如 slug=offline-mode）。Go 之后可继续就决策聊天，再进入 /speckit.specify。出现 Needs Clarification 时在聊天中回答问题或编辑指定 wiki 页面——不要重新跑完整漏斗。

/speckit.assess.intake "offline sync for field users" slug=offline-mode
/speckit.assess.research slug=offline-mode
/speckit.assess.define slug=offline-mode
/speckit.assess.shape slug=offline-mode
/speckit.assess.decide slug=offline-mode

推荐顺序

按此顺序运行命令。constitution 每个项目设置一次；其余命令按每个功能运行。

顺序	命令	是否必需	说明
—	/speckit.assess.*	可选	先评估想法（见上文）
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.specify 默认创建下一个编号 spec。仅在你明确要求时更新已有 spec（例如 update this spec 或指定 specs/001-feature-name）。specify 运行后，clarify、plan、tasks、analyze、converge 会保持在该功能上，直到你指定其他功能。

示例

/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。

对于文件更新，文件面板会显示真实的 +N / −N 行变更计数，以及 Diff 选项卡（Contents / Preview / Diff）。仅在存在上一版本且未处于编辑状态时显示 Diff。首次创建不显示 Diff。

/speckit.constitution

设定项目原则（每个项目一次）。预览草稿后选择 Keep。

/speckit.specify

在 Raaghu Spec Kit/specs/NNN-feature-name/ 下创建功能 spec（以及 requirements 等相关页面）。

/speckit.clarify

在聊天中提出澄清问题（通常带有 Optimal 建议）。回答这些问题，以便将缺口回写到规范中。

问题在聊天中一次显示一个（Back / Next，最后一题为 Submit Answer）。Idea Assessment 或 Intake 提出澄清问题时也使用同一流程。

/speckit.plan

生成实现计划及相关文件（plan、research、data-model 等）。

/speckit.checklist

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

/speckit.tasks

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

/speckit.analyze

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

工作流与命令

• 命令（/speckit.*）是你从聊天中直接运行的操作。
• Workflows 是 Workflows 选项卡中的引导式多步对话，使用同一引擎。

完整演练请参见 你的第一个功能。

下一步

• 上下文菜单
• 你的第一个功能
• Visual
• Workflows