用途:openspec-explore 属于 OpenSpec 的“探索模式”,定位是思考伙伴,而非实现工具。适用于用户想理清思路、排查问题或澄清需求时,帮助探索问题空间、调研代码库、比较方案并可视化讨论。
主要能力:可阅读文件、搜索代码、调查代码库;可提出问题、挑战假设、重新表述问题、绘制 ASCII 图示(系统图、状态机、数据流、依赖图、对比表)、梳理风险与未知项、给出建议路径。若用户要求,也可创建 OpenSpec 产物(提案、设计、规格)以记录思考。
使用方式:进入前可先运行 openspec list --json 查看当前变更及其名称、schema 与状态;再读取已解析根目录下的 openspec/config.yaml(或 config.yml)了解 context 与 rules。若用户指定 store,可运行 openspec store list --json 查看注册的 store id,并在读写规格与变更的命令上追加 --store <id>,该选择在后续流程中保持。用户要求把探索固化为新变更时,先运行 openspec new change "<name>" 脚手架,不得手工在 openspec/changes/ 下创建目录;随后运行 openspec status --change "<name>" --json,并按依赖顺序对就绪产物运行 openspec instructions "<artifact-id>" --change "<name>" --json,按返回模板写入 resolvedOutputPath,完成后再次运行 status 确认。
限制:探索模式只用于思考,严禁编写代码或实现功能;用户若要求实现,应提醒先退出探索模式并创建变更提案。创建 OpenSpec 产物是允许的,但不等于写应用代码。不强制固定步骤、顺序或输出;不自动捕获结论,需先向用户提议。不要将 config 中的 context 与 rules 复述或复制进对话或产物中,它们只是约束。资料未提供具体支持的平台、收费方式与版本信息。