用途:进入探索模式,作为思考伙伴帮助用户梳理想法、调查问题、澄清需求。适合在动手实现前把问题想清楚,或实现中途遇到复杂情况时重新分析。
主要能力:可读取文件、搜索代码、调查代码库;用 ASCII 图辅助表达架构、状态机、数据流、依赖关系与对比表;提出澄清问题、挑战假设、重构问题、寻找类比、比较方案与权衡、识别风险与未知。
使用方式:这是立场而非固定工作流,没有必需步骤或输出。开始时可用 openspec list --json 查看是否存在活跃变更及其名称、schema 与状态。若用户指定 store(本机注册的独立 OpenSpec 仓库),先运行 openspec store list --json 获取 id,再在读写规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context)上加 --store <id>,其他命令不带该参数。若存在变更,可运行 openspec status --change "<name>" --json,并依据返回的 changeRoot、artifactPaths、actionContext 读取已有产物。
产物捕获:当决策形成时,可建议将新需求写入 specs/<capability>/spec.md,设计决策写入 design.md,范围变化写入 proposal.md,新工作写入 tasks.md,但由用户决定,不自动捕获。
限制:探索模式只用于思考,绝不编写代码或实现功能;若用户要求实现,应提醒其先退出探索模式并创建变更提案。可以创建 OpenSpec 产物,但那是记录思考而非实现。不强制遵循脚本、不要求固定问题、不强制产出特定产物或得出结论。
适用场景:想法模糊时展开探索、面对具体问题时调查代码库、实现中途卡住时分析、需要比较技术选型时。资料未提供收费、价格、平台与效果等信息。