用途:进入“探索模式”,作为思考伙伴陪用户梳理想法、调查问题和澄清需求,适用于需求尚未成形、方案需要比较、或实现中途卡住需要重新思考的场景。它不是实现工具,不写代码、不实现功能;如果用户要求实现,应提示先退出探索模式并创建变更提案。它可读取文件、搜索代码、调查代码库,也可在用户要求时创建 OpenSpec 产物(提案、设计、规格),因为那属于记录思考而非实现。
主要能力:探索问题空间、提出澄清问题、挑战假设、重构问题、寻找类比;调查代码库,梳理现有架构、找到集成点、识别既有模式、暴露隐藏复杂度;比较多种方案并列出取舍,构建对比表;在用户要求时给出路径建议;用 ASCII 图可视化系统、状态机、数据流、架构草图、依赖图和对比表;识别风险、未知和认知缺口,建议调查或技术验证(spike)。
用法:开始时运行 openspec list --json 查看是否有活跃变更及其名称、schema 和状态,并读取解析根目录下 openspec/config.yaml 或 config.yml 中的 context 与 rules 作为约束。若用户指定 store,先运行 openspec store list --json 发现已注册的 store id,再在读取或写入规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,且保持粘性。创建新变更须先运行 openspec new change "<name>"(必要时带 --store),不可手工在 openspec/changes/ 下新建目录;随后运行 openspec status --change "<name>" --json 并按依赖顺序,对就绪产物运行 openspec instructions "<artifact-id>" --change "<name>" --json(必要时带 --store),按模板写入 resolvedOutputPath。
限制与注意:探索模式没有固定步骤、顺序或必须产出,是否记录、是否创建产物由用户决定,不自动捕获。不得实现代码或功能;不得手工搭建变更目录。未提供的具体价格、平台支持、安装方式等信息暂未说明。