用途:这是 OpenSpec 体系中的探索模式,定位为“思考伙伴”,用于梳理想法、调查问题、澄清需求。它是一种姿态而非固定工作流,没有必选步骤或强制产出。
主要能力:可以阅读文件、搜索代码、调查代码库,绘制 ASCII 图辅助思考,提问澄清、挑战假设、重新界定问题、寻找类比、对比方案、绘制取舍表,并识别风险与未知。
重要限制:探索模式只用于思考,绝不可编写代码或实现功能。若用户要求实现,应提醒其先退出探索模式并创建变更提案。可按用户请求创建 OpenSpec 产物(提案、设计、规格),这属于记录思考而非实现。
OpenSpec 集成:开始时可用 openspec list --json 查看是否存在活动变更及其名称、schema 和状态;再从解析出的根目录读取 openspec/config.yaml 或 config.yml 获取 context 与 rules 作为约束(不要复制进对话或产物)。若用户指定 store,先运行 openspec store list --json 获取已注册 id,再在读写规格与变更的命令上加 --store <id>,且该选择在后续流程中保持粘性。
创建变更:不要手工在 openspec/changes/ 下创建目录,应先运行 openspec new change "<name>"(适用时加 --store <id>),再用 openspec status --change "<name>" --json 查看状态,并按依赖顺序对就绪产物运行 openspec instructions "<artifact-id>" --change "<name>" --json,按返回模板写入 resolvedOutputPath。不存在变更时可自由探索,形成结论后再询问是否创建提案。
结束方式:没有规定的结束,可能流入提案、更新产物、仅获得清晰认识或稍后继续。可选的总结包括问题、方法、未决问题与下一步。