SuperAPI AI 工具集

openspec-explore

智能体与模型

查看项目

更新于 10-15 12:56

技能介绍

用途

openspec-explore 是一个“探索模式”技能,作为思考伙伴,帮助用户探索想法、调查问题、澄清需求。它适用于用户想要深入思考、梳理问题、比较方案或理解代码库的场景。

主要能力

  • 探索问题空间:提出自然涌现的澄清问题、挑战假设、重构问题、寻找类比。
  • 调查代码库:梳理与讨论相关的现有架构、寻找集成点、识别已有模式、暴露隐藏的复杂性。
  • 比较选项:头脑风暴多种方案、构建对比表格、勾勒权衡、在被要求时推荐路径。
  • 可视化:大量使用 ASCII 图,包括系统图、状态机、数据流、架构草图、依赖图、对比表格。
  • 暴露风险与未知:识别可能出错的地方、发现理解缺口、建议技术验证或调查。
  • OpenSpec 上下文感知:通过 openspec list --json 检查现有变更;读取 openspec/changes/<name>/proposal.md、design.md、tasks.md 等工件;在对话中自然引用;在决策产生时建议将洞察记录到相应工件(新需求到 specs/<capability>/spec.md,需求变更到 specs/<capability>/spec.md,设计决策到 design.md,范围变更到 proposal.md,新工作到 tasks.md,假设失效到相关工件)。

使用方式

该技能是一种立场,而非工作流。没有固定步骤、必需顺序或强制输出。用户可以从模糊想法、具体问题、实现中途卡住或方案对比等不同入口进入。技能会根据用户带来的内容自适应:跟随有趣的线索,在新信息出现时转向,不急于下结论,让问题的形状自然浮现。

适用场景

  • 用户想深入思考某个想法或需求。
  • 用户想调查代码库中的问题或架构。
  • 用户想比较不同技术方案。
  • 用户想澄清需求或挑战假设。
  • 用户想梳理风险与未知。

限制

  • 探索模式只用于思考,不用于实现。绝不编写代码或实现功能。
  • 如果用户要求实现,会提醒先退出探索模式并创建变更提案。
  • 可以创建 OpenSpec 工件(提案、设计、规格)来记录思考,但不编写应用代码。
  • 不强制结构,不自动捕获洞察,由用户决定是否记录。
  • 没有必需的结束方式:可能流入提案、更新工件、仅提供清晰度、或稍后继续。

其他说明

该技能强调:不要伪造理解,不清楚就深入挖掘;不要匆忙,探索是思考时间;不要强制结构,让模式自然涌现;不要自动捕获,建议保存洞察而非直接执行;要可视化,一张好图胜过许多段落;要探索代码库,让讨论扎根现实;要质疑假设,包括用户的和自己的。