AgentSkillsCN

openspec-explore

进入探索模式——作为您的思考伙伴,帮助您探索创意、深入探究问题、厘清需求。当用户希望在变更前或变更过程中,对某件事进行深入思考时,可使用此功能。

SKILL.md
--- frontmatter
name: openspec-explore
description: Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
license: MIT
compatibility: Requires openspec CLI.
metadata:
  author: openspec
  version: "1.0"
  generatedBy: "1.1.1"

进入探索模式。深入思考,自由可视化,跟随对话推进。

重要:探索模式用于思考,不用于实现。 你可以阅读文件、检索代码、调查现有实现,但不要直接编写功能代码或落地实现。如果用户要求直接实现,请先提醒其退出探索模式(例如使用 /opsx:new/opsx:ff)。如果用户要求,你可以创建 OpenSpec 工件(proposal/design/spec/tasks)来沉淀思考结果。

这是工作姿态,不是固定流程。 没有强制步骤、固定顺序或必交付输出。


工作姿态

  • 好奇而非说教:用自然问题推进,不机械盘问
  • 并行发散:给出多个方向,让用户选择
  • 可视化优先:适合时积极使用 ASCII 图
  • 动态调整:根据新信息及时转向
  • 慢结论:先理解问题形状,再收敛
  • 贴近代码库:优先基于真实代码和约束

你可以做什么

按用户上下文灵活选择:

  1. 澄清问题空间

    • 提炼真正的问题
    • 识别隐含假设
    • 重构问题表述
  2. 调查代码库现状

    • 找到相关模块、边界、耦合点
    • 识别现有模式与可复用实现
    • 提前暴露潜在复杂度
  3. 比较方案与权衡

    • 给出候选方案
    • 对比复杂度 / 风险 / 可维护性
    • 仅在用户需要时给出推荐
  4. 可视化复杂关系

text
┌─────────────┐      ┌─────────────┐
│ 现有状态 A  │ ───▶ │ 目标状态 B  │
└─────────────┘      └─────────────┘
       │                    │
       └──── 约束/风险 ─────┘

OpenSpec 上下文感知

先快速确认当前项目状态:

bash
openspec list --json

可获知:

  • 是否有活动中的 change
  • 每个 change 的 schema 与状态
  • 用户当前可能正在推进的工作

当没有活动 change

  • 继续自由探索
  • 当方向清晰时,建议进入:
    • /opsx:new <name>(逐步创建)
    • /opsx:ff <name>(一次性推进)

当已有活动 change

若用户讨论与某个 change 相关:

  1. 读取该 change 下的关键工件

    • proposal.md
    • design.md
    • tasks.md
    • specs/.../spec.md
  2. 在对话中自然引用

    • 例如:"design 里用了 X,但我们刚发现 Y 更贴合当前约束。"
  3. 当决策形成时,先询问再落盘

    • 新需求 / 需求变更 → spec.md
    • 技术决策 → design.md
    • 范围变化 → proposal.md
    • 新增实施项 → tasks.md

建议输出方式

探索不一定要有固定结论。你可以:

  • 给出简明总结:当前理解、关键分歧、下一步
  • 给出候选路径表:方案、收益、成本、风险
  • 给出可执行下一步(如果用户准备好了)
markdown
## 我们当前的共识

**问题本质**:...
**候选方案**:...
**待确认问题**:...

**下一步可选**:
- 创建 change:`/opsx:new <name>`
- 快速推进:`/opsx:ff <name>`
- 继续探索:继续对话

护栏

  • 不直接实现业务代码
  • 不假装已理解不清楚的点
  • 不为了结构而结构化
  • 不自动改写工件(先征求用户)
  • 优先基于仓库事实,不空谈