用途:在当前项目中初始化 OpenSpec,以支持 Superspec 工作流,并确保 superspec-rpi schema 可用。适用于项目尚未初始化 OpenSpec,或缺少 superspec-rpi schema 的场景。
前置条件:OpenSpec CLI 必须已安装并在 PATH 中。
主要流程:
- 运行 openspec --help 验证 OpenSpec 是否存在;若失败,提示用户安装 OpenSpec 后重新运行本技能,不要继续。
- 运行 openspec init --tools none 初始化。若命令出现交互式提示(如清理问题),立即停止并询问用户,不要自动添加 --force。初始化无提示成功后进入下一步。
- 确认 openspec/schemas/superspec-rpi/ 目录存在。必要时先创建父目录:mkdir -p openspec/schemas/superspec-rpi/templates。若缺失,按 assets 中的规范文件逐字复制创建 schema.yaml 及 templates 下的 proposal.md、spec.md、design.md、tasks.md;若已存在则校验而非覆盖。
- 运行 openspec schema validate superspec-rpi --json 校验。失败时展示 JSON 摘要(优先 issues),不确定如何总结则展示完整 JSON,并询问用户是编辑 schema 文件还是重新初始化。
- 运行 openspec schemas --json 确认 superspec-rpi 出现在输出中。
- 输出固定结果:Superspec initialized successfully / Selected schema: superspec-rpi / Next: /superspec-research。
限制:复制文件必须逐字进行,不得自行编造或改写;引用保持一层深度(SKILL.md -> assets/*);目标文件已存在时只校验不覆盖。资料未提供 OpenSpec 的安装方式、版本要求及 schema 具体内容。