用途:进入“探索模式”,作为一个思考伙伴,帮助用户深入思考、发散想法、调查问题和澄清需求。资料强调这是一种立场而非固定工作流,没有固定步骤、顺序或必须产出。
主要能力:提出自然涌现的澄清问题;挑战假设、重构问题、寻找类比;调查代码库,梳理现有架构、集成点、既有模式与隐藏复杂度;比较多种方案并给出对比表与取舍草图;用 ASCII 图可视化架构、状态机、数据流、依赖图;识别风险与未知;在用户要求时给出推荐路径。可以读取文件、搜索代码、调查代码库,但绝不写代码或实现功能。
使用方式:资料给出的命令包括 openspec list --json 用于查看现有变更;读取解析根目录下的 openspec/config.yaml(或 config.yml)获取项目上下文与规则。若用户指定 store,先运行 openspec store list --json 发现已注册的 store id,然后在读写规格与变更的命令上追加 --store <id>(如 new change、status、instructions、list、show、validate、archive、doctor、context、view),一旦选定即在该工作流中保持。无 store 时命令作用于最近的本地 openspec/ 根目录。需捕获探索结果为新变更时,先执行 openspec new change "<name>" 脚手架,禁止手工在 openspec/changes/ 下创建目录;再运行 openspec status --change "<name>" --json,并按依赖顺序对就绪产物运行 openspec instructions "<artifact-id>" --change "<name>" --json,按返回模板写入解析出的输出路径。产物创建后重新运行 status,直至所有请求产物完成或按条件跳过。
适用场景:用户想法模糊需要发散、遇到具体问题需要排查、实现中途卡住需要梳理、需要比较技术选项等。当已有变更存在时,可读取其产物并自然引用,在形成决策后建议将洞察捕获到相应产物:新需求或需求变更写入 specs/<capability-path>/spec.md,设计决策写入 design.md,范围变化写入 proposal.md,新工作写入 tasks.md。
限制:探索模式不实现功能;若用户要求实现,应提醒其先退出探索模式并创建变更提案。创建 OpenSpec 产物属于“捕获思考”,是允许的。不编造理解、不急于下结论、不强制结构、不自动捕获(应提议而非直接保存)、不手工搭建变更目录。若被请求的产物依赖用户未请求且无法条件跳过的前置产物,应先说明依赖并征求同意后再扩展捕获。资料未提供收费、价格、平台支持范围等信息。