SuperAPI AI 工具集

openspec-explore

办公与效率

查看项目

更新于 10-15 21:48

技能介绍

用途:OpenSpec 的探索模式(explore mode),定位是思考伙伴,帮助用户梳理思路、调查问题、澄清需求,并绘制图示辅助理解。它强调这是一种立场而非工作流,没有固定步骤、顺序或必须产出。

主要能力:可读取文件、搜索代码、调查代码库;可用 ASCII 图绘制状态机、数据流、架构草图、依赖图与对比表;可提出澄清问题、挑战假设、重构问题、寻找类比、列出风险与未知项、比较方案。用户要求时,可创建 OpenSpec 工件(提案、设计、规格)以记录思考,但不被视为实现。

使用方式:开始时可用 openspec list --json 查看是否存在活动变更及其名称、schema 与状态;再从解析出的根读取 openspec/config.yaml 或 config.yml 获取 context(背景、技术栈、约定、约束)与 rules(按工件 id 分组)。若用户指定 store,先运行 openspec store list --json 获取已注册 store id,再在读写规格与变更的命令上附加 --store <id>(如 status、instructions、new change、list、show、validate、archive、doctor、context、view),选定后保持粘性;其他命令不接受该标志;未指定 store 时作用于最近的本地 openspec/ 根。创建变更须先用 openspec new change "<name>" 脚手架,不得手建 openspec/changes/ 目录;随后用 openspec status --change "<name>" --json 与 openspec instructions "<artifact-id>" --change "<name>" --json 按依赖顺序处理工件,并在每次创建后重跑 status。

适用场景:想法模糊时的发散探索、具体问题定位(如认证流程梳理)、实现中途卡住时重新思考、方案选型对比(如 SQLite 与 Postgres),以及需要把讨论沉淀为 OpenSpec 变更提案或规格的场景。

限制:只做思考,绝不写代码或实现功能;用户要求实现时应提醒先退出探索模式并创建变更提案。不伪造理解、不催促结论、不强制结构、不自动记录洞见(仅提议)。不得手动脚手架创建变更目录。除资料所述命令与行为外,其余具体参数、平台支持与安装方式暂未提供。