Back to Details

openspec-explore

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenSpec Explore Skill

OpenSpec Explore Skill

Use 
/opsx:explore
 to think through ideas, investigate problems, compare options, and clarify requirements — all without creating any artifacts or committing to a structure. When insights crystallize, transition to openspec-new or openspec-ff.
使用**
/opsx:explore
梳理想法、调查问题、对比方案并明确需求——全程无需创建任何工件或确定结构。当思路清晰后，可切换至openspec-new或openspec-ff**。

When to Use

使用场景

  • Requirements are unclear and the user needs to investigate first.
  • Comparing multiple approaches before deciding on one.
  • The user wants to explore the codebase for improvement opportunities.
  • Brainstorming before a formal change proposal.
  • 需求不明确，用户需要先进行调研时。
  • 在确定方案前对比多种实现路径时。
  • 用户想要探索代码库以寻找改进机会时。
  • 提交正式变更提案前进行头脑风暴时。

Prerequisites

前置条件

  • OpenSpec initialized in the project (see openspec-initial).
  • 项目中已初始化OpenSpec（详见openspec-initial）。

Workflow

工作流程

  1. Start exploration
    • Run 
      /opsx:explore
      or 
      /opsx:explore [topic]
      .
    • The agent opens an exploratory conversation with no structure required.
  2. Investigate
    • Analyze the codebase, compare options, create diagrams, answer questions.
    • No artifacts are created during exploration — it is purely a thinking exercise.
  3. Transition when ready
    • When the user has clarity, suggest 
      /opsx:new <change-name>
      to start a formal change.
    • Or 
      /opsx:ff <change-name>
      if they want to create all planning artifacts at once.
  1. 启动探索
    • 运行
      /opsx:explore
      或
      /opsx:explore [主题]
      。
    • Agent会开启一场无固定结构的探索式对话。
  2. 开展调研
    • 分析代码库、对比方案、创建图表、解答问题。
    • 探索过程中不会创建任何工件——这纯粹是一个思维梳理的过程。
  3. 适时切换
    • 当用户思路清晰后，建议使用
      /opsx:new <变更名称>
      启动正式变更流程。
    • 若想一次性创建所有规划工件，可使用
      /opsx:ff <变更名称>
      。

Outputs

输出结果

  • No artifacts or files are created. The output is the conversation itself — insights, options, recommendations.
  • 不会创建任何工件或文件。输出内容即为对话本身——包括见解、可选方案、建议等。

Next Steps

后续步骤

  • When ready to act: use openspec-new to start a change, or openspec-ff to fast-forward through planning.
  • 准备执行时：使用openspec-new启动变更，或使用openspec-ff快速完成规划环节。

Troubleshooting

故障排查

  • "Commands not recognized": Ensure OpenSpec is initialized (
    openspec init
    ). See openspec-initial.
  • “命令未被识别”：确保已初始化OpenSpec（
    openspec init
    ）。详见openspec-initial。

References

参考资料