SuperAPI AI 工具集

openspec-explore

编程与开发

查看项目

更新于 11-03 17:15

技能介绍

openspec-explore 是 OpenSpec 体系中的探索模式技能,核心定位是“思考伙伴”,用于在动手实现之前探索想法、调查问题并澄清需求。

用途

该技能用于进入探索模式,深入思考并自由可视化,跟随对话自然推进。它可以阅读文件、搜索代码、调查代码库,但明确不写代码、不实现功能。如果用户要求实现某项功能,技能会提醒用户先退出探索模式并创建变更提案。它可以在用户要求时创建 OpenSpec 产物(提案、设计、规格),因为这属于“记录思考”而非实现。

主要能力

  • 探索问题空间:提出澄清性问题、挑战假设、重新表述问题、寻找类比。
  • 调查代码库:梳理与讨论相关的现有架构、寻找集成点、识别已有模式、揭示隐藏复杂度。
  • 比较方案:头脑风暴多种方案、构建对比表格、勾勒取舍并在被要求时给出路径建议。
  • 可视化:大量使用 ASCII 图示表达系统图、状态机、数据流、架构草图、依赖图和对比表。
  • 浮现风险与未知:识别可能出错之处、发现理解缺口、建议技术验证或调查。
  • 感知 OpenSpec 上下文:开始时检查当前变更列表,读取项目配置中的背景(技术栈、约定、约束)与规则,并以此作为思考约束。
  • 在无变更时自由思考,当想法成形时提议创建变更提案;在已有变更时读取现有产物并在对话中自然引用,出现新需求、设计决策、范围变化或假设失效时,询问是否捕获到对应产物。

使用方式

该技能没有固定步骤或强制输出,是一种姿态而非工作流。使用中会涉及 OpenSpec CLI 命令,例如列出变更、查看状态、获取产物创建指令、创建新变更等。若涉及已注册的独立 store,需要先发现 store id,并在读取或写入规格与变更的相关命令上固定携带 --store 参数。创建新变更必须通过 openspec new change 命令脚手架完成,不得手工在 openspec/changes/ 下创建目录,以确保生成 .openspec.yaml 等必要元数据。

适用场景

适合需求讨论、架构梳理、方案比较(如数据库选型)、实现中途遇到复杂度时的思路梳理、技术调研与设计决策记录等场景。用户可以从模糊想法、具体问题、实现卡点或方案对比等不同入口进入。

限制

该技能不写代码、不实现功能;不伪造理解,不清楚时需深入探究;不急于下结论;不强制结构化;不自动捕获洞察,而是先提议;不手工搭建变更目录。对话中的具体命令执行需要本机安装并配置 OpenSpec CLI,具体安装与配置方式资料暂未提供。