用途:这是一项教学型技能,带用户在真实代码库中完成首个完整的 OpenSpec 工作流周期,边做边讲,从想法到实现全部走一遍。
前置检查与使用方式:先运行 openspec status --json 2>&1 || echo "NOT_INITIALIZED" 检查是否已初始化;若未初始化,需先运行 openspec init,然后回到 /opsx-onboard,否则流程停止。
主要能力流程:依次包含欢迎说明、任务选择(扫描 TODO/FIXME、缺失错误处理、无测试函数、类型问题、调试残留、缺失校验,并查看 git log --oneline -10)、探索演示、创建变更(openspec new change "<derived-name>")、撰写提案、规格(需求/场景的 WHEN/THEN/AND 格式)、设计、任务清单,然后实现并把复选框改为已完成,最后归档。归档使用 openspec archive "<name>",变更会移动到 openspec/changes/archive/YYYY-MM-DD-<name>/。生成提案时可运行 openspec instructions proposal --change "<name>" --json。
相关命令参考:/opsx-explore 用于思考问题;/opsx-new 新建变更并逐步生成产物;/opsx-ff 一次性快速生成全部产物;/opsx-continue 继续已有变更;/opsx-apply 实现任务;/opsx-verify 校验实现与产物一致;/opsx-archive 归档。
适用场景:希望在真实代码任务中学习 OpenSpec 完整协作与决策记录流程的用户;建议选择 1-2 个文件、约 20-30 行的小任务。
限制与注意:需已初始化 OpenSpec,否则无法继续;首次演练任务过大时会软性提示改小,但尊重用户选择;中途可暂停,进度保存在 openspec/changes/<name>/,后续可用 /opsx-continue 或 /opsx-apply 恢复;要求使用真实代码库任务,不模拟或使用假示例。其余价格、平台等信息暂未提供。