用途:这是 OpenSpec 体系中的“探索模式”技能,定位是思考伙伴,帮助用户探索想法、调查问题和澄清需求。它不是固定工作流,没有必需步骤或强制产出,可跟随对话自由展开。
主要能力:可读取文件、搜索代码、查看代码库、运行只读命令或工具,无需确认;可用 ASCII 图辅助可视化;可围绕问题进行澄清、挑战假设、重新表述问题、发现类比、梳理架构与集成点、比较方案与权衡、指出风险与未知。探索阶段可引用已有的 OpenSpec 变更产物,如提案、设计、规格。
使用方式:开始时可运行 openspec list --json 查看是否存在活跃变更及其名称、模式与状态,并读取项目根目录下 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 生成各产物。
适用场景:想法尚模糊时梳理方向;排查代码库中的具体问题(如认证流程混乱);实现中途卡住时重新审视;方案选型比较(如 SQLite 与 Postgres);需求澄清与范围界定。
限制:探索模式只用于思考,绝不写代码或实现功能,工作流配置(模式、模板、openspec/config.yaml)的创建或编辑也不算思考;仅允许在已确认范围内创建或更新 OpenSpec 变更产物。回答设计或澄清性问题不构成写入许可;首次具备写入能力的操作前,必须说明将改动的产物或文件及做法,提出直接的 yes/no 问题,并等待用户在单独消息中确认,确认只覆盖所述范围。用户要求实现时应提醒其先退出探索模式并创建变更提案。提问前应先检查现有 OpenSpec 产物、源码、测试、文档与配置,不重复询问可验证的事实;无 store 时命令作用于最近的本地 openspec/ 根目录。本资料未提供收费、价格、平台与效果信息。