用途
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,假设失效到相关工件)。
使用方式
该技能是一种立场,而非工作流。没有固定步骤、必需顺序或强制输出。用户可以从模糊想法、具体问题、实现中途卡住或方案对比等不同入口进入。技能会根据用户带来的内容自适应:跟随有趣的线索,在新信息出现时转向,不急于下结论,让问题的形状自然浮现。
适用场景
- 用户想深入思考某个想法或需求。
- 用户想调查代码库中的问题或架构。
- 用户想比较不同技术方案。
- 用户想澄清需求或挑战假设。
- 用户想梳理风险与未知。
限制
- 探索模式只用于思考,不用于实现。绝不编写代码或实现功能。
- 如果用户要求实现,会提醒先退出探索模式并创建变更提案。
- 可以创建 OpenSpec 工件(提案、设计、规格)来记录思考,但不编写应用代码。
- 不强制结构,不自动捕获洞察,由用户决定是否记录。
- 没有必需的结束方式:可能流入提案、更新工件、仅提供清晰度、或稍后继续。
其他说明
该技能强调:不要伪造理解,不清楚就深入挖掘;不要匆忙,探索是思考时间;不要强制结构,让模式自然涌现;不要自动捕获,建议保存洞察而非直接执行;要可视化,一张好图胜过许多段落;要探索代码库,让讨论扎根现实;要质疑假设,包括用户的和自己的。