SuperAPI AI 工具集

openspec-explore

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:进入 OpenSpec 的 explore 模式,作为思考伙伴,在 OpenSpec 变更之前或进行中调查问题、比较选项、澄清需求。该模式用于思考而非实现,可读取文件、搜索代码、调查代码库,但不编写代码或实现功能;若用户要求实现,应提醒其退出探索模式并先使用 /openspec-ff-change。仅在用户明确要求时创建 OpenSpec 产物,因为那只是记录思考,不算实现。

主要能力:以好奇而非规定性的姿态提问,让问题自然浮现;开放多条线索而非审问;在有助于澄清时大量使用 ASCII 图;根据新信息灵活转向;耐心等待问题成形;基于真实代码库而非空想。可探索问题空间、调查代码库(梳理架构、找集成点、暴露隐藏复杂度)、比较选项(头脑风暴、对比表、权衡取舍、按需推荐路径),并自由可视化状态图、数据流、架构草图、依赖图、对比表。

使用方式:开始时可用 openspec list --json 查看活跃变更、其 schema 与状态,感知用户可能在做的事。无变更时可自由思考,当洞察成形时,可无压力地提议用 /openspec-ff-change 创建提案。有变更时,读取其产物获取上下文(openspec/changes/<name>/proposal.md、design.md、tasks.md 等)并自然引用,提议将成形的洞察记录到对应位置(specs/<capability>/spec.md 中的需求、design.md 中的设计决策、proposal.md 中的范围变更、tasks.md 中的新工作),由用户决定,绝不自动记录。

适用场景:需要在动手前理清问题、比较方案、澄清需求,或围绕 OpenSpec 变更进行探索性讨论时。

限制:不实现、不写应用代码;不假装理解,不清楚时深入挖掘;不急于推进、不强行结构化;不自动捕获洞察;没有固定步骤、必需顺序或强制输出,也没有固定完成状态,探索模式在用户获得清晰认识、做出决定或自然停止时结束。