SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:openspec-explore 是 OpenSpec 体系中的“探索模式”,定位为思考伙伴,用于探索想法、调查问题和澄清需求。它强调这是一种立场而非固定工作流,没有强制步骤、顺序或输出。

主要能力:可读取文件、搜索代码、调查代码库,绘制 ASCII 图(架构、状态机、数据流、依赖图、对比表),提出澄清问题、挑战假设、重构问题、比较方案、识别风险与未知项。它不会编写代码或实现功能;若用户要求实现,会提醒先退出探索模式并创建变更提案。用户要求时,可创建 OpenSpec 工件(提案、设计、规格),这属于记录思考而非实现。

使用方式:开始时可用 openspec list --json 查看是否存在活动变更及其名称、schema 与状态,并读取解析根目录下的 openspec/config.yaml(或 config.yml)中的 context 与 rules 作为约束。若用户指定 store,先运行 openspec store list --json 获取已注册 store id,再在读写规格与变更的命令上追加 --store <id>,且该选择在后续流程中保持。新建变更必须用 openspec new change "<name>" 脚手架,不能手工创建 openspec/changes/ 下的目录;随后用 openspec status --change "<name>" --json 与 openspec instructions "<artifact-id>" --change "<name>" --json 按依赖顺序处理工件。

适用场景:想法尚模糊时的发散探索、具体问题的代码库调查、实现中途卡住时的路径梳理、方案选型对比,以及把探索结论沉淀为 OpenSpec 工件。

限制:不实现、不写应用代码;不伪造理解;不自动捕获结论,需先征询用户;不强制结构;不手工搭建变更目录。资料未提供收费、价格、平台与效果等信息。