用途:在已使用 OpenSpec 的项目中进入探索模式,作为思考伙伴帮助探索想法、调查问题和澄清需求。它定位为一种思考姿态而非固定工作流,没有强制步骤、顺序或必产出物。
主要能力:提出澄清性问题、挑战假设、重新表述问题、寻找类比;调查代码库,梳理现有架构、集成点和已有模式;比较方案并以对比表呈现取舍;绘制 ASCII 图(状态机、数据流、架构草图、依赖图);识别风险与未知点,建议调查或验证。
使用方式与限制:可读取文件、搜索代码并运行只读命令,但绝不写代码或实现功能,实现应转向 /openspec-propose。可在确认范围内创建或更新 OpenSpec 变更产物(提案、设计、规格)。首次写操作前需说明将修改的产物或文件并请求明确确认;用户明确要求将探索记录为新变更即视为该确认。涉及指定 store 时先运行 openspec store list --json,并在相关读写命令追加 --store <id>。写操作前用 openspec list --json 读取 root 确认项目已初始化;root 为 null 时按自动选择与显式请求两种情形分别处理,不得擅自创建根目录。规划变更时先查证已有 OpenSpec 产物、源码、测试、文档与配置,再提事实性问题。
适用场景:需求尚不清晰、需要探索问题空间、调研代码库、比较方案或记录设计决策。限制:不实现、不自动记录、不强制产出;未提供的信息暂未说明。