用途
openspec-explore 是 OpenSpec 工作流中的“探索模式”技能,用于把 AI 变成思考伙伴,帮助用户探索想法、调查问题、澄清需求。它的核心定位是“思考,而不是实现”。
主要能力
- 探索问题空间:提出自然涌现的澄清问题、挑战假设、重新表述问题、寻找类比。
- 调查代码库:梳理与讨论相关的现有架构、寻找集成点、识别已有模式、暴露隐藏复杂度。
- 比较方案:头脑风暴多种路径、构建对比表、勾勒权衡、在被要求时推荐一条路径。
- 可视化:大量使用 ASCII 图,包括系统图、状态机、数据流、架构草图、依赖图、对比表。
- 识别风险与未知:指出可能出错的地方、理解上的缺口,并建议调研或 spike。
- OpenSpec 上下文感知:通过
openspec list --json检查是否存在活跃变更及其名称、schema 和状态;读取openspec/changes/<name>/proposal.md、design.md、tasks.md等工件作为上下文,并在对话中自然引用。
使用方式
该技能没有固定步骤、必需顺序或强制产出,是一种姿态而非工作流。AI 会保持好奇、开放式提问、跟随对话走向、耐心等待问题轮廓浮现,并在相关时基于真实代码库展开讨论。
在探索过程中,如果洞察逐渐成形,AI 可能建议将决策捕获到对应工件:新需求或需求变更写入 specs/<capability>/spec.md,设计决策写入 design.md,范围变化写入 proposal.md,新工作写入 tasks.md,失效假设写入相关工件。但由用户决定,AI 只提供建议,不自动捕获。
当没有变更存在时,AI 可以自由思考;当洞察足够清晰时,可能建议“这感觉可以开始一个变更了,要我创建一个吗?”,可过渡到 /opsx:new 或 /opsx:ff,也可以继续探索。
当用户提到某个变更或检测到相关变更时,AI 会读取现有工件作为上下文,并自然引用,例如指出设计文档提到 Redis 但刚意识到 SQLite 更合适,或提案把范围限定为高级用户但现在考虑面向所有人。
适用场景
- 用户带来模糊想法,例如“我在考虑加入实时协作”。
- 用户带来具体问题,例如“认证系统一团糟”。
- 用户卡在实现中途,例如
/opsx:explore add-auth-system且 OAuth 集成比预期复杂。 - 用户想比较选项,例如“该用 Postgres 还是 SQLite?”。
限制
- 探索模式用于思考,不用于实现。可以读取文件、搜索代码、调查代码库,但绝不能编写代码或实现功能。
- 如果用户要求实现,AI 会提醒先退出探索模式(例如通过
/opsx:new或/opsx:ff启动变更)。 - 可以创建 OpenSpec 工件(提案、设计、规格),前提是用户要求——这属于捕获思考,而非实现。
- 没有必需产出或固定流程;总结是可选的,有时思考本身就是价值。
- 不伪造理解、不急于下结论、不强制结构、不自动捕获洞察。