用途
OpenSpec Explore 是一个“探索模式”技能,作为思考伙伴,帮助用户探索想法、调查问题、澄清需求。它适用于用户想要深入思考、梳理问题、比较方案或理解代码库的场景。
主要能力
- 探索问题空间:提出自然涌现的澄清问题、挑战假设、重构问题、寻找类比。
- 调查代码库:映射与讨论相关的现有架构、寻找集成点、识别已有模式、揭示隐藏的复杂性。
- 比较选项:头脑风暴多种方案、构建对比表格、勾勒权衡、在被要求时推荐路径。
- 可视化:大量使用 ASCII 图表,如系统图、状态机、数据流、架构草图、依赖图、对比表格。
- 识别风险与未知:找出可能出错的地方、理解上的缺口,建议技术验证或调查。
使用方式
该技能是一种姿态,而非工作流。没有固定步骤、必需顺序或强制输出。用户可以从模糊想法、具体问题、实现中途的卡点或方案对比等不同入口进入。技能会跟随对话自然展开,自适应地追踪有趣线索,在出现新信息时转向。
它具备 OpenSpec 上下文感知:开始时可通过 openspec list --json 快速检查现有变更(名称、模式、状态)。当没有变更时,可自由思考,并在洞察成熟时建议创建提案。当存在变更时,可读取现有工件(如 openspec/changes/<name>/proposal.md、design.md、tasks.md 等)作为上下文,并在对话中自然引用。当决策产生时,可建议将洞察记录到相应工件:新需求记录到 specs/<capability>/spec.md,需求变更记录到 specs/<capability>/spec.md,设计决策记录到 design.md,范围变更记录到 proposal.md,新工作记录到 tasks.md,假设失效记录到相关工件。但由用户决定是否记录,技能只提供建议,不自动捕获。
适用场景
- 用户带来模糊想法,例如“我在考虑添加实时协作”。
- 用户带来具体问题,例如“认证系统一团糟”。
- 用户卡在实现中途,例如
/opsx:explore add-auth-system且 OAuth 集成比预期复杂。 - 用户想要比较选项,例如“我们应该用 Postgres 还是 SQLite?”。
限制
- 探索模式只用于思考,不用于实现。绝不编写代码或实现功能。
- 如果用户要求实现,会提醒其先退出探索模式并创建变更提案。
- 可以在用户要求时创建 OpenSpec 工件(提案、设计、规格),因为这属于记录思考,而非实现。
- 不伪造理解:如果不清楚,会深入挖掘。
- 不急于求成:探索是思考时间,不是任务时间。
- 不强制结构:让模式自然涌现。
- 不自动捕获:建议保存洞察,但不直接执行。
- 没有必需的结尾:探索可能流入提案、导致工件更新、仅提供清晰度、或稍后继续。总结是可选的,有时思考本身就是价值。