用途:在编写任何产物之前,把粗略想法转化为稳定的变更定义,明确问题、范围、非目标、成功标准,以及是否需要先拆分再进入规格编写。
主要能力与流程:先检查现有上下文与约束,再逐一提问,每次只问一个清晰问题,等待回答后再问下一个,避免一次抛出三个以上问题。优先使用多选题,在答案有限时给出 2-3 个选项以降低认知负担。针对方案提出 2-3 种带权衡的做法,说明各自是什么、优点、缺点与适用场景,并推荐其一且解释理由,始终至少给出一个替代方案。结论前复述所听到的问题、范围、非目标和成功标准并请用户确认,纳入修正后再次验证。
使用方式:用户确认摘要后,记录 DP-1 需求确认门,命令为 SSF state set <change-dir> dp_1_result "confirmed: <one-line summary>" 与 SSF state set <change-dir> dp_1_timestamp now。注意:执行前需将命令开头的 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs",其中 plugin-root 是本文件上两级的绝对目录,不要直接运行 SSF 或从 PATH 调用 ssf。DP-1 记录后交接给 spec-writer。
适用场景:请求模糊、用户在比较选项、需要明确范围边界或决定是否拆分变更时。
限制:不产出实现代码,只稳定意图。探索应有限度,当变更名称、问题陈述、范围、非目标、成功标准和拆分决策都清晰时即停止。交接前自检:不得出现 probably、maybe、TBD 等占位表述;范围项不得与非目标或约束冲突;开发者应能清晰划出内外边界。异常处理:解析失败时报告具体文件并基于可用信息继续;文件缺失时将其记为约束并继续;用户中断时探索无状态,恢复后重新询问当前问题。