SuperAPI AI 工具集

openspec-explore

智能体与模型

查看项目

更新于 10-16 08:47

技能介绍

用途:进入 explore 探索模式,作为思考伙伴帮助用户梳理想法、调查问题、澄清需求。该模式是思考而非实现,可读取文件、搜索代码、调查代码库,但绝不写代码或实现功能;若用户要求实现,应提醒其先退出探索模式并创建变更提案。若用户要求,可以创建 OpenSpec 工件(提案、设计、规格),因为这属于记录思考而非实现。

主要能力:以好奇而非规定性的姿态提问,开放多条线索、用 ASCII 图辅助思考、跟随对话走向、保持耐心、结合实际代码库。可视需要探索问题空间、挑战假设、重新表述问题、调查代码库、绘制现有架构与集成点、比较多种方案并列出权衡、识别风险与未知。

使用方式:开始时先运行 openspec list --json 查看是否存在活动变更及其名称、模式和状态,并读取项目自身的 context 与 rules 作为约束(不要复制进对话或工件)。若用户指定 store(本机注册的独立 OpenSpec 仓库),先运行 openspec store list --json 获取 id,再在读写规格与变更的命令上加 --store <id> 并全程保持。当用户要求把探索沉淀为变更时,先用 openspec new change "<name>" 脚手架(不要手工创建变更目录),再依次运行 openspec status --change "<name>" --json 和 openspec instructions "<artifact-id>" --change "<name>" --json,按依赖顺序处理工件,写入解析后的输出路径后再次运行 status 确认。

适用场景:用户带着模糊想法、具体问题、实现中途的困惑或方案对比需求时均可使用。

限制:没有固定步骤、流程或必需产出;不实现功能、不写应用代码;不自动沉淀,需先提议再获用户确认;不确定处应深入而非臆测。