SuperAPI AI 工具集

openspec-explore

编程与开发

查看项目

更新于 10-15 09:59

技能介绍

用途

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 工件(提案、设计、规格),前提是用户要求——这属于捕获思考,而非实现。
  • 没有必需产出或固定流程;总结是可选的,有时思考本身就是价值。
  • 不伪造理解、不急于下结论、不强制结构、不自动捕获洞察。