SuperAPI AI 工具集

openspec-explore

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:进入 explore(探索)模式,作为思考伙伴陪用户发散想法、调查问题、澄清需求,并把结论沉淀为 OpenSpec 工件(提案、设计、规格)。该模式只用于思考,不用于实现。

主要能力:可就问题空间提问、挑战假设、重新表述问题;可阅读文件、搜索代码、调查代码库,映射现有架构、找出集成点与既有模式;可比较方案、列出权衡、绘制 ASCII 图(架构、状态机、数据流、依赖图、对比表);可识别风险与未知、提出 spike 或调查建议。除创建 OpenSpec 工件外,禁止编写代码或实现功能;用户要求实现时,提示先退出探索模式并创建变更提案。

使用方式:开始时快速检查上下文,运行 openspec list --json;再读取解析出的根目录下 openspec/config.yaml(或 config.yml)中的 context 与 rules。若用户指定 store,先运行 openspec store list --json 获取已注册 id,再在读写规格与变更的相关命令上加 --store <id>,且后续保持粘性。若用户要求把探索固化为新变更,必须先运行 openspec new change "<name>"(适用时加 --store <id>)完成脚手架,禁止手工创建 openspec/changes/ 下的变更目录;随后按依赖顺序运行 openspec status --change "<name>" --json 与 openspec instructions "<artifact-id>" --change "<name>" --json,按模板写入 resolvedOutputPath;每完成一个工件后重新运行 status,直到全部完成或按条件有意跳过。已存在变更时,用 status JSON 的 changeRoot、artifactPaths、actionContext 读取现有工件并在对话中自然引用,提出把洞见写入 specs/<capability-path>/spec.md、design.md、proposal.md 或 tasks.md,由用户决定,不自动捕获。

适用场景:想法模糊需发散时、遇到具体棘手问题需定位时、实现中途卡住需重新梳理时、需要比较技术选项时。

限制:无固定步骤、无强制输出、无必需结论;不实现、不编造理解、不强行结构化、不自动捕获、不手工搭建变更目录;是否沉淀与采用何种方案由用户决定。