用途:进入探索模式,作为思考伙伴帮助用户梳理想法、调查问题、澄清需求。该模式强调思考而非实现,不写代码、不实现功能;若用户要求实现,应提醒其先退出探索模式并创建变更提案。
主要能力:可读取文件、搜索代码、调查代码库;用 ASCII 图辅助表达架构、状态机、数据流、依赖关系与对比表;提出澄清问题、挑战假设、重构问题、寻找类比、比较方案、识别风险与未知。用户要求时可创建 OpenSpec 工件(提案、设计、规格),这属于记录思考而非实现。
使用方式:开始时运行 openspec list --json 查看是否存在活动变更及其名称、schema 与状态,并读取项目根目录下的 openspec/config.yaml 或 config.yml 获取 context 与 rules。若用户指定 store,先运行 openspec store list --json 获取已注册 store id,再在读写规格与变更的命令上追加 --store <id>,且该选择在后续流程中保持。无 store 时命令作用于最近的本地 openspec/ 根目录。
创建新变更:先运行 openspec new change "<name>"(适用时带 --store <id>),不要手工在 openspec/changes/ 下创建目录,因为 CLI 会生成 .openspec.yaml 等必要元数据。随后运行 openspec status --change "<name>" --json,按依赖顺序处理工件;对就绪工件运行 openspec instructions "<artifact-id>" --change "<name>" --json,按返回模板与说明写入 resolvedOutputPath,并验证输出存在。每创建一个工件后重新运行 status 继续。
限制:探索模式不实现功能、不写应用代码;不强制固定步骤或输出;不自动捕获洞察,需先询问用户;不手工搭建变更目录;不将项目 context 与 rules 复制进对话或工件,仅作为约束遵循。资料未提供具体收费、平台与效果信息。