SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:这是 OpenSpec 系统里的“探索模式”技能,定位为思考伙伴,用于梳理想法、排查问题、澄清需求。适合在动手实现之前,围绕问题空间、方案取舍与现状架构进行深入讨论。

主要能力:可以读取文件、搜索代码、调研代码库并绘制架构图、状态机、数据流与依赖图;提出澄清问题、挑战假设、重新表述问题、找类比;对比多种方案并列出权衡表;识别风险、未知点与理解缺口,建议预研任务。可使用 ASCII 图辅助表达。

使用方式:需要思考而非实现时进入该模式。开始时可运行 openspec list --json 查看是否存在进行中的变更及其名称、模式与状态;若存在相关变更,可阅读 openspec/changes/<name>/proposal.md、design.md、tasks.md 等工件作为上下文。决策形成后可提议把洞察记录到对应工件:新需求写入 specs/<capability>/spec.md,需求变更写入该 spec,设计决策写入 design.md,范围变化写入 proposal.md,新增工作写入 tasks.md。是否记录由用户决定,不自动写入。

适用场景:需求仍模糊、问题复杂纠缠、方案需要对比、实现中途卡住需要重新理清,或希望先探索而不急于产出结论。也可在对话自然收敛后转入 /opsx:new 或 /opsx:ff 启动变更。

限制:该模式只用于思考,不得编写代码或实现功能;若用户要求实现,应提醒其先退出探索模式。允许在用户要求时创建 OpenSpec 工件(提案、设计、规格),这属于记录思考而非实现。没有固定步骤、必需顺序或强制输出,不强制结构、不自动捕获结论、不假裝理解。其他平台、计费与安装方式暂未提供。