用途:OpenSpec Onboard 提供交互式教程,带用户走完 OpenSpec 的完整工作流。它基于用户真实代码库,寻找实际改进点,创建真实变更、实现并归档,让用户第一手体验各 OPSX 命令。
适用时机:首次使用 OpenSpec 想动手演练;用户提到 onboard、tutorial 或想了解 OpenSpec 如何工作;在正式工作前先学习流程。
前提:项目已初始化 OpenSpec(参见 openspec-initial)。
使用方式:运行 /opsx:onboard 开始。教程阶段包括欢迎与代码库分析、寻找改进机会(小而安全的改动)、创建变更(/opsx:new)、编写提案、创建规格、编写设计、创建任务、实现任务(/opsx:apply)、验证实现、归档变更、总结与后续步骤。过程中智能体逐步解释,用户选择要处理的改进点,创建的变更是真实的,可保留或丢弃。
输出:使用真实代码库完成一次从提案到归档的完整变更周期,用户获得每个 OPSX 命令的实操经验。
后续:可用 openspec-new 或 openspec-explore 开始实际工作。
限制与排错:命令无法识别时确认已执行 openspec init;教程覆盖完整流程,预计 15-30 分钟;若代码库维护良好找不到合适改进,可建议文档改进或小重构作为教程变更;实现失败时检查生成任务的范围,必要时简化变更或丢弃并选更小的改进。
参考:OpenSpec 命令 /opsx:onboard。