SuperAPI AI 工具集

openspec-explore

智能体与模型

查看项目

更新于 10-19 16:18

技能介绍

用途

openspec-explore 用于进入 OpenSpec 的“探索模式”,做用户的思考伙伴,围绕想法探索、问题调查和需求澄清展开对话。它强调这是思考而非实现:可以读文件、搜代码、调查代码库,但绝不写代码或实现功能。

主要能力

  • 探索问题空间:提出澄清问题、挑战假设、重新表述问题、寻找类比。
  • 调查代码库:梳理相关架构、找集成点、识别既有模式、暴露隐藏复杂度。
  • 比较方案:头脑风暴多种做法、制作对比表、勾勒权衡,必要时给出建议。
  • 可视化:按需使用 ASCII 图表达系统结构、状态机、数据流、架构草图、依赖图和对比表。
  • 识别风险与未知项,指出理解缺口,建议做探针或调查。

使用方式

没有固定步骤、必需顺序或强制输出,是一种姿态而非工作流。开始时可运行 openspec list --json 快速了解是否存在活动变更及其名称、schema 和状态。存在相关变更时,可读取 openspec/changes/<name>/proposal.md、design.md、tasks.md 等制品作为上下文,并在对话中自然引用。当洞察成型时,可提议把新需求记入 specs/<capability>/spec.md、设计决策记入 design.md、范围变化记入 proposal.md、新工作记入 tasks.md,但是否记录由用户决定,不自动写入。

适用场景

适合用户带着模糊想法(如“想加实时协作”)、具体问题(如“认证系统很乱”)、实现中途遇到困难,或需要在多个方案间做选择时使用。也可在探索成熟后转入 /opsx:new <name> 或 /opsx:ff <name> 开始变更。

限制

不得编写应用代码或实现功能;创建 OpenSpec 制品属于记录思考,允许。不伪造理解,不急于下结论,不强加结构,不自动捕获洞察;总结属可选,有时思考本身就是价值。