SuperAPI AI 工具集

openspec-explore

办公与效率

查看项目

更新于 10-15 21:48

技能介绍

用途:OpenSpec 的探索模式(explore mode),定位为思考伙伴,帮助用户梳理想法、调查问题、澄清需求。适合在动手实现前进行方案讨论、架构调研、需求澄清与风险识别。

主要能力:以好奇心驱动提问、挑战假设、重新表述问题、寻找类比;调查代码库,梳理现有架构、集成点与既有模式,暴露隐藏复杂度;对比多种方案、绘制权衡表并给出建议(如用户要求);用 ASCII 图呈现系统图、状态机、数据流、依赖关系与对比表;识别风险与未知项,建议调研或 spike。

使用方式:用户可直接以 $openspec-explore(Codex)或 /openspec-explore(其他 agent)触发。开始时可用 openspec list --json 查看是否存在活跃变更及其名称、schema、状态,并读取解析出的根目录下 openspec/config.yaml 或 config.yml 中的 context 与 rules 作为约束(不复制进对话或产物)。若非本机注册的独立 store,需先运行 openspec store list --json 获取 id,并在读写的相关命令上追加 --store <id>,且后续沿用。

限制:探索模式只用于思考,不写代码、不实现功能;用户要求实现时应提醒先退出并创建变更提案。可以创建 OpenSpec 产物(提案、设计、规格)以捕获思考。创建新变更必须先运行 openspec new change "<name>",不得手工在 openspec/changes/ 下建目录。创建产物时按依赖顺序执行 openspec status 与 openspec instructions,并遵循返回的模板与指令。不自动捕获洞察,需先征询用户;不强迫产出特定产物或达成结论。

适用场景:模糊想法发散(如实时协作)、具体问题排查(如认证流程混乱)、实现中途遇到意外复杂度、方案对比(如 Postgres 与 SQLite)。结束方式不固定,可流入提案、更新产物、仅提供清晰认知或留待后续继续。