用途 openspec-explore 是 OpenSpec 体系中的“探索模式”技能,帮助用户在实现之前把想法想清楚。它把自己定位为思考伙伴,而不是执行工具:用于探索想法、调查问题、澄清需求。
主要能力
- 通过自然提问帮助澄清问题,挑战假设,重新表述问题,寻找类比。
- 在相关时调查实际代码库,包括梳理现有架构、寻找集成点、识别已有模式、发现隐藏复杂度。
- 对比多种方案,建立比较表,勾勒取舍,并在用户要求时给出推荐路径。
- 使用 ASCII 图辅助表达,例如系统图、状态机、数据流、架构草图、依赖图和比较表。
- 识别风险与未知,发现理解缺口,建议进行技术验证或调查。
使用方式 该技能没有固定工作流、必需步骤或强制输出,跟随对话灵活展开。开始时可通过以下命令快速检查 OpenSpec 上下文: openspec list --json 该命令显示是否存在活跃变更,以及名称、schema 和状态。若已有变更,可读取以下产物获取上下文: openspec/changes/<name>/proposal.md openspec/changes/<name>/design.md openspec/changes/<name>/tasks.md 当讨论中形成决策或发现新需求时,技能可以建议把内容记录到对应产物中,例如新需求或需求变更记录到 specs/<capability>/spec.md,设计决策记录到 design.md,范围变化更新 proposal.md,新工作记录到 tasks.md,失效假设更新相关产物。是否记录由用户决定,技能只提出建议,不自动记录。
适用场景
- 用户只有一个模糊想法,例如考虑增加实时协作功能,需要先厘清方向。
- 用户带着具体问题,例如认证系统混乱,需要结合实际代码梳理问题。
- 用户实现到一半卡住,需要回到思考层面分析。
- 用户需要比较技术选型,例如 Postgres 与 SQLite。
限制 探索模式只用于思考,不用于实现。技能可以读取文件、搜索代码和调查代码库,但绝不能编写代码或实现功能。如果用户要求实现,应提醒其先退出探索模式并创建变更提案。技能可以创建 OpenSpec 产物(提案、设计、规格)以记录思考,但这不属于实现。探索没有必需结尾,可能自然形成提案、更新产物、仅提供清晰理解或留待后续继续。