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/ 文件夹下创建需求质量检查清单。若该检查清单文件已存在，再次运行命令会 更新 它 — 流程仍为 Keep / Regenerate，并在已有上一版本时显示 +N / −N 计数与 Diff 选项卡。
/speckit.tasks
将计划拆分为分阶段的 tasks 列表。
/speckit.analyze
交叉检查 spec、plan、tasks 与 constitution。结果以分析报告形式出现在聊天中（缺口、严重程度与建议）。
工作流与命令
- 命令（
/speckit.*）是你从聊天中直接运行的操作。 - Workflows 是 Workflows 选项卡中的引导式多步对话，使用同一引擎。
完整演练请参见 你的第一个功能。