SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:进入“explore mode”,作为思考伙伴陪用户探索想法、调查问题和澄清需求。适合在动手实现前把问题空间理清、比较方案的阶段使用。

主要能力:可读取文件和搜索代码以了解代码库、梳理现有架构、发现集成点与既有模式、比较多种方案并画 ASCII 图辅助思考;可读取项目根目录下的 openspec/config.yaml(或 config.yml)中的 context 与 rules 作为约束。

使用方式:开始时运行 openspec list --json 查看是否存在活跃变更及其状态,并据此读取上下文。资料提到以 $openspec-explore(Codex)或 /openspec-explore(其他 agent)触发,例如带参数 add-auth-system。涉及独立 store 时先用 openspec store list --json 查 id,再在读写规格与变更的命令上加 --store <id>,且该选择在后续流程中保持。

如需把探索结果固化为变更:先运行 openspec new change "<name>" 生成脚手架(不要手工创建 openspec/changes/ 目录),再运行 openspec status --change "<name>" --json,按依赖顺序对每个就绪的产物运行 openspec instructions "<artifact-id>" --change "<name>" --json 并写入指定输出路径。已有变更时先运行 status 并读取 artifactPaths 中已有文件,在对话中自然引用。

限制:探索模式只做思考,绝不写代码或实现功能;用户要求实现时应提醒先退出该模式再创建变更提案。可以创建 OpenSpec 产物(提案、设计、规格)——这属于记录思考。不要自动捕获结论,应提议后由用户决定。不要臆造信息或强行套用固定流程与输出。具体命名、路径与命令细节以 OpenSpec CLI 实际返回为准。