SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:openspec-explore 是 OpenSpec 的探索模式(explore mode),定位为“思考伙伴”,用于梳理想法、调查问题、澄清需求。它是一种姿态而非固定工作流,没有固定步骤、顺序或必须产出。

主要能力:可阅读文件、搜索代码、调查代码库,用 ASCII 图辅助表达;帮助探索问题空间、挑战假设、重构问题、比较方案、绘制权衡表、识别风险与未知、发现集成点与既有模式。可依据用户要求创建 OpenSpec 工件(提案、设计、规格),这属于记录思考而非实现功能。

使用方式:开始时可用 openspec list --json 检查是否存在活动变更;再从解析出的根目录读取 openspec/config.yaml(或 config.yml)中的 context 与 rules,作为约束遵循但不复制到对话或工件中。若指定了 store,先运行 openspec store list --json 获取已注册 store id,然后在读写规格与变更的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)后追加 --store <id>,并保持其“粘性”。未指定 store 时,命令作用于最近的本地 openspec/ 根目录。需要新建变更时,必须先用 openspec new change "<name>" 脚手架化,不可手工创建 openspec/changes/ 下的目录;随后用 openspec status --change "<name>" --json 和 openspec instructions "<artifact-id>" --change "<name>" --json 按依赖顺序处理工件。涉及 --store 的命令示例:openspec status --change "<name>" --json --store "<id>"。

适用场景:需求尚不明确、需要发散讨论;已有变更需要回溯设计或规格;实现途中遇到复杂点需要重新评估;需要在多个技术选项间比较。

限制:探索模式禁止写代码或实现功能,用户要求实现时应提示其退出探索模式并创建设计变更提案。不要伪造理解、不要急于结论、不要强制结构、不要自动捕获洞察,创建工件前应征得同意。资料未提供具体的收费、平台支持范围或效果承诺信息。