SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 11-02 01:06

技能介绍

用途

OpenSpec Explore 是一个“探索模式”技能,作为思考伙伴,帮助用户探索想法、调查问题和澄清需求。它被设计为一种“姿态”而非固定工作流:没有固定步骤、必需顺序或强制产出,主要用于在动手实现之前把问题想清楚、把需求聊透。

主要能力

  • 深入思考并自由可视化:在有助于澄清思路时大量使用 ASCII 图,例如系统图、状态机、数据流、架构草图、依赖图和对比表。
  • 顺着对话自然推进:提出自然浮现的问题,而不是照脚本逐条询问;打开多个有趣方向,让用户选择共鸣之处。
  • 扎根代码库:在相关时实际阅读文件、搜索代码、调查代码库,映射现有架构、寻找集成点、识别已有模式,避免纯理论空谈。
  • 处理不同类型入口:面对模糊想法时,帮助展开问题空间;面对具体问题时,调查现状并指出纠缠点;面对实现中途的卡点,读取变更制品并梳理相关选项;面对方案比较时,结合具体上下文给出对比分析。
  • 记录与固化:在用户要求时,可以创建 OpenSpec 制品(提案、设计、规格),并支持引导创建新的变更。

使用方式

该技能通过对话式交互使用,常见入口包括 $openspec-explore(Codex)或 /openspec-explore(其他代理)。开始时会快速检查当前 OpenSpec 状态,例如运行 openspec list --json 查看是否有活跃变更及其名称、模式和状态;并读取项目自身的上下文配置(如 openspec/config.yaml 或 config.yml)中的 context(技术栈、约定、约束)和 rules(按制品 id 组织的规则),将其作为思考约束而非需要复述的内容。若用户指定了已注册的独立 OpenSpec 仓库(store),会先运行 openspec store list --json 发现 store id,并在读取或写入规格与变更的相关命令上追加 --store <id>,且在选择后保持粘性。

当不存在变更时,可自由思考;当洞察成熟时,可询问用户是否要创建提案,或继续探索。若用户要求把探索固化为新变更,会先运行 openspec new change "<name>" 搭建脚手架(不手工在 openspec/changes/ 下创建目录),再按依赖顺序处理请求的制品,过程中使用 openspec status 与 openspec instructions 等命令,并遵循返回的模板与指令字段。当已存在变更时,会解析并阅读已有制品,在对话中自然引用其内容,并在决策形成时询问是否将新需求、设计决策、范围变化等捕获到对应制品中,由用户决定,不自动捕获。

适用场景

  • 在动手实现前梳理一个模糊的产品或技术想法。
  • 调查代码库中某个混乱或复杂的部分(如认证流程),定位关键纠缠点。
  • 在实现过程中遇到比预期更复杂的问题,需要重新评估设计与路径。
  • 在多个技术选项之间做有上下文的比较与权衡(如 SQLite 与 Postgres)。
  • 需要把讨论中形成的共识整理成 OpenSpec 提案、设计或规格。

限制与边界

该模式只用于思考,不用于实现:可以读取文件、搜索代码、调查代码库,但绝不会编写代码或实现功能;若用户要求实现,会提醒其先退出探索模式并创建变更提案。创建 OpenSpec 制品是允许的,因为那属于记录思考而非实现。它也不会伪造理解、不急于下结论、不强加结构、不自动捕获洞察,并且不会手工搭建变更目录,必须通过 openspec new change 命令创建,以确保生成 .openspec.yaml 等必需元数据。

暂未提供

该技能的收费、价格、平台支持范围、具体效果指标等未在资料中提供。