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