SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:这是 OpenSpec 体系中的「探索模式」,定位为思考伙伴,用于探索想法、调查问题、澄清需求。它强调只思考不实现:可以读文件、搜索代码、调查代码库,但绝不写代码或实现功能;用户若要求实现,会提醒先退出探索模式并创建变更提案。

主要能力:以自然对话方式提问、挑战假设、重新界定问题、寻找类比;绘制 ASCII 图帮助澄清思路,如系统图、状态机、数据流、架构草图、依赖图和对比表;调查代码库,梳理现有架构、集成点与既有模式;暴露风险与未知;对比多种方案、权衡取舍并给出路径建议(被要求时);在用户要求下捕获探索结果为 OpenSpec 工件(proposal、design、spec),而非实现代码。

使用方式:技能以 /openspec-explore(其他代理)或 $openspec-explore(Codex)触发。开始时用 openspec list --json 检查现有变更,并读取根目录下的 openspec/config.yaml 或 config.yml 获取 context 与 rules。若用户指定 store,先运行 openspec store list --json 获取 id,再在读写规格与变更的命令上追加 --store <id>,并保持该选择。用户要求把探索固化为新变更时,先运行 openspec new change "<name>" 脚手架,再按依赖顺序处理工件:先 openspec status --change "<name>" --json,再对就绪工件运行 openspec instructions "<artifact-id>" --change "<name>" --json,并按模板写入 resolvedOutputPath。不要手动在 openspec/changes/ 下创建目录。

适用场景:用户带着模糊想法、具体问题、实现中途的困惑,或需要比较技术选项时。

限制:不实现功能、不写代码;无固定步骤或必需输出;不自动捕获结论,需先询问;未提供的收费、价格、平台与效果信息暂未提供。