用途:这是 OpenSpec 的探索模式(explore),定位为思考伙伴,帮助用户探讨想法、调查问题和厘清需求。它是一种「姿态」而非固定工作流,没有固定步骤、顺序或强制产出。适合在动手实现前先把问题想清楚,也适合实现中途卡住时重新梳理方向。
主要能力:可以带着好奇心提问、挑战假设、重新定义问题、寻找类比;调查代码库、梳理现有架构、找集成点、识别既有模式;对比多种方案、画对比表、梳理取舍;用 ASCII 图示意系统结构、状态机、数据流、依赖关系等;识别风险与未知项、指出理解缺口、建议做探针式调查。
使用方式:先运行 openspec list --json 查看是否存在活跃变更及其名称、schema 和状态;再从解析出的根目录读取 openspec/config.yaml 或 config.yml 中的 context(项目背景、技术栈、约定、约束)与 rules(按产物 id 分组)。若用户点名某个已注册的独立仓库(store),先运行 openspec store list --json 获取 id,再在读写规范与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,选定后保持粘性。若用户要求把探索固化为新变更,先用 openspec new change "<name>" 脚手架(不得手工在 openspec/changes/ 下建目录),再按依赖顺序逐个产物运行 openspec instructions "<artifact-id>" --change "<name>" --json,遵循模板与说明,必要时按说明作有条件跳过,并反复用 openspec status 检查进度。
限制:探索模式绝不写代码或实现功能;如用户要求实现,应提醒先退出探索模式并创建变更提案。允许在用户要求时创建 OpenSpec 产物(提案、设计、规范),因为那是记录思考而非实现。不要凭空臆断,不清楚就深入挖掘;不要急于下结论;不要强制套用结构;不要自动捕获洞见,应主动询问用户是否记录;不要手工搭建变更目录。