用途:进入“探索模式”,与用户一起思考、调研代码库、澄清需求。这是一�种思考姿态而非固定工作流,没有必须的步骤或输出。
主要能力:提出澄清问题、挑战假设、重新框定问题、寻找类比;调研代码库、梳理现有架构、找出集成点与既有模式、暴露隐藏复杂度;对比多个方案、构建对照表、画出取舍与 ASCII 图;识别风险与未知项,建议 spike 或调研。
使用方式:可选指定 store(本机注册的独立 OpenSpec 仓库),用 openspec store list --json 查看 id,再对读写 spec/change 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)加 --store <id> 并保持粘性;无 store 时作用于最近的本地 openspec/ 根。开始时可运行 openspec list --json 查看活跃变更,并读取 <root.path>/openspec/config.yaml(或 config.yml)中的 context 与 rules 作为约束,不要复制进对话或工件。用户要求把探索沉淀为新变更时,先运行 openspec new change "<name>" 脚手架,再运行 openspec status --change "<name>" --json,按依赖顺序对就绪工件运行 openspec instructions "<artifact-id>" --change "<name>" --json,按模板与指令写入 resolvedOutputPath,逐件完成后重跑 status。
适用场景:想法尚模糊时发散探索、遇到具体问题需定位、实现中途卡住需梳理、需要比较技术选型。
限制:禁止写代码或实现功能;用户要求实现时应提示先退出探索模式并创建变更提案。可创建 OpenSpec 工件但不得手工在 openspec/changes/ 下新建目录,必须用 CLI 脚手架。不要自动捕捉洞察,需先提议再由用户决定。其他细节资料未提供。