用途:这是一项教学型引导技能,带用户在自己的代码库中完成第一次完整的 OpenSpec 工作流循环,边做真实改动边讲解每一步。
主要能力:按阶段推进——欢迎、任务选择(扫描 TODO/FIXME、缺失错误处理、缺测试函数、any 类型、调试残留、缺校验,并查看 git 最近提交)、探索演示、创建变更、提案、规格、设计、任务、实施、归档、回顾与下一步。产物之间遵循 proposal → specs → design → tasks 的顺序,规格采用 Requirement 加 WHEN/THEN/AND 场景的可测格式。附带软性范围护栏,建议先选 1-2 个文件、约 20-30 行的小任务;并支持中途退出的优雅处理与快速命令参考。
使用方式:先确认 CLI 已安装:openspec --version 2>&1 || echo "CLI_NOT_INSTALLED"(Windows 用 if (Get-Command openspec -ErrorAction SilentlyContinue) { openspec --version } else { echo "CLI_NOT_INSTALLED" }),未安装需先安装再回到 /opsx:onboard。若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上附加 --store <id>(new change、status、instructions、list、show、validate、archive、doctor、context),其他命令不加;不指定 store 时作用于最近的本地 openspec/ 根目录。创建变更用 openspec new change "<derived-name>";各产物路径通过 openspec instructions proposal|specs|design|tasks --change "<name>" --json 的 resolvedOutputPath 确定;完成用 openspec archive "<name>",归档至 planningHome.changesDir 下的 archive/YYYY-MM-DD-<name>/。常用命令包括 /opsx:propose、/opsx:explore、/opsx:apply、/opsx:archive,以及 /opsx:new、/opsx:continue、/opsx:ff、/opsx:verify。
适用场景:希望学习并实践 OpenSpec 规格驱动开发流程的开发者,尤其适合首次使用、需要一个完整示范流程的人。
限制:必须已安装 OpenSpec CLI,否则流程直接终止;流程强调使用真实代码库任务,不使用模拟示例;任务过大时仅作软性劝导,用户坚持可覆盖;资料未说明收费、价格、平台支持范围或效果保证,暂未提供。