用途:openspec-explore 是 OpenSpec 体系中的“探索模式”,定位为思考伙伴,用于探索想法、调查问题和澄清需求。它强调这是一种立场而非固定工作流,没有强制步骤、顺序或输出。
主要能力:可读取文件、搜索代码、调查代码库,梳理现有架构、集成点与既有模式,暴露隐藏复杂度;可提出澄清问题、挑战假设、重构问题、寻找类比;可头脑风暴多种方案、构建对比表、绘制 ASCII 图(状态机、数据流、架构草图、依赖图等)、识别风险与未知项,并在被要求时给出路径建议。
使用方式:进入探索模式后,可先运行 openspec list --json 查看是否存在活跃变更及其名称、schema 与状态,并读取解析根目录下的 openspec/config.yaml(或 config.yml)中的 context 与 rules 作为约束。若用户指定了 store,先运行 openspec store list --json 获取已注册 store id,再在读写规格与变更的命令上追加 --store <id>,且该选择在后续流程中保持。若用户要求把探索固化为新变更,先运行 openspec new change "<name>" 脚手架,再运行 openspec status --change "<name>" --json,并按依赖顺序对就绪工件运行 openspec instructions "<artifact-id>" --change "<name>" --json,按返回模板写入 resolvedOutputPath。
适用场景:想法尚模糊时的发散讨论、具体问题排查、实现中途卡住时的分析、方案选型对比,以及把讨论结论沉淀为提案、设计或规格。
限制:探索模式只用于思考,绝不写代码或实现功能;用户要求实现时应提醒其退出探索模式并创建变更提案。可以创建 OpenSpec 工件,但不得手工在 openspec/changes/ 下创建变更目录,必须使用 CLI 脚手架以生成 .openspec.yaml 等元数据。不要自动捕获结论,应主动提议由用户决定。资料未提供收费、价格、平台与效果等信息。