用途:进入 explore 探索模式,作为思考伙伴,帮助用户探索想法、调查问题、厘清需求。适合在动手实现前把问题想清楚,而不是直接写代码。
主要能力:以好奇、开放、可视化的姿态对话,可提澄清问题、挑战假设、重新表述问题、寻找类比;可读取文件、检索代码、调查代码库,梳理现有架构、集成点、既有模式与隐藏复杂度;可对比多种方案、列出取舍、绘制 ASCII 图(状态机、数据流、架构草图、依赖图等);可识别风险与未知、指出理解缺口、建议调研或 spike。
使用方式:它是姿态而非固定流程,没有必需步骤或输出。开始时可运行 openspec list --json 查看现有 active changes 的名称、schema 与状态,并从解析出的根目录读取 openspec/config.yaml(或 config.yml)中的 context 与 rules 作为约束。若用户指明 store,先运行 openspec store list --json 获取 id,再在读写 spec 与 change 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,并在后续保持。无 store 时作用于最近的本地 openspec/ 根目录。需要新建 change 时必须先运行 openspec new change "<name>" 脚手架,不可手工在 openspec/changes/ 下建目录;随后用 openspec status --change "<name>" --json 与 openspec instructions "<artifact-id>" --change "<name>" --json 按依赖顺序创建工件。
适用场景:用户有模糊想法、遇到具体难题、实现中途卡住、想比较技术选型等情况。
限制:探索模式只用于思考,不写代码、不实现功能;若用户要求实现,应提醒其先退出探索模式并创建 change 提案。创建 OpenSpec 工件属于记录思考,是允许的。不要假装理解、不催促结论、不强制结构、不自动捕获洞察,须先询问再保存。