用途:通过在一个真实的小任务上实际运行一次完整的 OpenSpec 周期,边做边讲解,让用户学会整套流程与各 /openspec-* 技能的触发方式,而不是先讲后做。
主要能力与流程:先做预检,检查 CLI 是否安装(openspec --version 或 PowerShell 等价命令),未安装则提示先安装并停止;检查 openspec/config.yaml 与 openspec/schemas/rhdh-spec-driven/ 是否存在,缺失时先调用 /rhdh-spec-driven-schema 并执行其项目安装步骤。随后依次进行:欢迎说明(约 15-20 分钟)、任务选择(扫描 TODO/FIXME/HACK/XXX、被吞掉的错误、缺测试的函数、TypeScript 的 any/as any、console.log/debugger、缺少校验的输入处理,并用 git log --oneline -10 查看近期活动,给出 3-4 个具体建议)、探索演示(/openspec-explore)、创建变更(/openspec-new-change,生成 openspec/changes/<name>/)、提案(/openspec-continue-change)、规格与设计(两者为兄弟关系,均只依赖提案,可任意顺序,各调用一次 /openspec-continue-change)、任务(/openspec-continue-change 写 tasks.md)、实现(/openspec-apply-change)、归档(/openspec-archive-change,移至 openspec/changes/archive/YYYY-MM-DD-<name>/)、回顾与命令参考。设计存在真实未决问题时,可选调用外部 /grilling 技能,未安装则提示 /setup-rhdh-skills install 后继续。
使用方式:按阶段调用上述技能,遵循 EXPLAIN -> DO -> SHOW -> PAUSE 节奏,在探索后、提案后、任务后、归档后暂停确认。
适用场景:希望系统学习 OpenSpec 工作流的开发者,尤其是首次接触者。
限制:需已安装 OpenSpec CLI;必须使用真实代码库任务,不得模拟或编造;范围过大时仅温和建议拆分,尊重用户最终选择;中途退出时说明工作已保存在 openspec/changes/<name>/,可用 /openspec-continue-change 或 /openspec-apply-change 继续,不施压。