用途:openspec-explore 是 OpenSpec 系统中的探索模式,定位为“思考伙伴”,用于在动手实现前探索想法、调查问题、澄清需求。它强调这是一种立场而非固定工作流,没有强制步骤、顺序或输出。
主要能力:可读取文件、搜索代码、调查代码库,梳理现有架构、集成点与已有模式,暴露隐藏复杂度;可提出澄清问题、挑战假设、重新表述问题、寻找类比;可头脑风暴多种方案、制作对比表、勾勒取舍、在被要求时推荐路径;可识别风险与未知、发现理解缺口、建议做技术验证(spike);可大量使用 ASCII 图辅助表达系统图、状态机、数据流、架构草图、依赖图与对比表。
使用方式:进入探索模式后,可先运行 openspec list --json 查看是否存在活跃变更及其名称、schema 与状态。若用户提到某个变更,可运行 openspec status --change "<name>" --json,并利用返回的 changeRoot、artifactPaths、actionContext,从 artifactPaths.<artifact>.existingOutputPaths 读取已有产物作为上下文。当洞察成形时,可询问用户是否要创建变更提案;当做出决策时,可提议将新需求写入 specs/<capability>/spec.md、设计决策写入 design.md、范围变化写入 proposal.md、新工作写入 tasks.md,但由用户决定,不自动捕获。
适用场景:用户带着模糊想法、具体问题、实现中途的困惑,或需要比较方案时。例如讨论实时协作、梳理混乱的认证系统、在实现 OAuth 时遇到复杂度,或比较 Postgres 与 SQLite 的取舍。
限制:探索模式只用于思考,绝不编写代码或实现功能;若用户要求实现,应提醒其先退出探索模式并创建变更提案。可以创建 OpenSpec 产物(提案、设计、规格),因为那是记录思考而非实现。不要伪造理解、不要急于下结论、不要强行套用结构、不要自动保存洞察。官方资料未提供安装命令、收费与平台信息。