speckit-check

Spec Kit 检查技能

运行 specify check，验证 Spec Kit CLI 和所需工具（git、AI Agent、编辑器）是否已安装且可检测到。在运行 speckit-install 或 speckit-initial 后使用此命令确认环境；如果用户反馈斜杠命令缺失或 specify 无法使用，也可使用此命令。

使用时机

• 使用 speckit-initial 初始化项目后，确认环境。
• 斜杠命令未显示，或用户表示“specify 无法使用”时。
• 在 CI 或脚本中运行 Spec Kit 步骤前，确保依赖项已就绪。

前提条件

• 必须已安装 Specify CLI（参见 speckit-install）。如果 specify 不在 PATH 中，请引导用户先使用 speckit-install，再运行 specify check。

工作流

1. 确认 CLI 可用

   • 如果用户尚未安装 CLI，或反馈“specify: command not found”，请先引导其使用 speckit-install。在 specify 可用之前，不要运行 specify check。

2. 运行检查

   • 在项目根目录（或目标目录）中运行：specify check
   • 该命令会报告检测到的工具（例如 git、claude、gemini、code、cursor-agent、windsurf、qwen、opencode、codex、shai、qoder），以及缺失或不在 PATH 中的工具。

3. 解读输出

   • 所有必需工具均已就绪：环境已准备好；建议继续使用 speckit-constitution 或 speckit-specify。
   • CLI 缺失：引导用户使用 speckit-install。
   • Agent 或编辑器缺失：建议安装相应的 Agent/编辑器，或将其可执行文件添加到 PATH。如果用户只需要模板和 .specify/（不需要斜杠命令），建议使用 --ignore-agent-tools 重新运行 speckit-initial。

4. 总结并给出建议

   • 简要总结哪些内容正常、哪些内容缺失。
   • 提供明确的后续步骤：安装 CLI（speckit-install）、使用其他 Agent 重新初始化（speckit-initial），或修复 PATH/安装 Agent。

输出

• 总结：检测到和缺失的工具。
• 建议：后续操作列表（安装 CLI、运行初始化、安装 Agent、添加到 PATH，或使用 specify init --ignore-agent-tools）。

后续步骤

• 如果有内容缺失：使用 speckit-install（安装 CLI）或 speckit-initial（重新初始化或使用 --ignore-agent-tools），或者安装缺失的 Agent/编辑器。
• 如果检查通过：继续使用 speckit-constitution 或 speckit-specify。

示例输出（参考）

参见 examples/sample-output.md，了解 specify check 输出示例及其解读方式。

故障排除

• “specify: command not found”：使用 speckit-install。
• Agent 报告为缺失：确保已安装 Agent 应用，且其 CLI 或可执行文件位于 PATH 中；如果只需要模板，也可以使用 specify init --ignore-agent-tools。
• 缺少 Git：安装 git；如果工作流不需要 git，也可以运行 specify init --no-git。

参考

• GitHub spec-kit — CLI：specify check