hany-question

name	hany-question
description	引导用户形成完整技术问题描述，生成结构化问题草稿。
author	hany
version	1.0

hany-question — 问题澄清助手

触发方式：/hany:question

调用方：可独立触发 /hany:question，也可由 hany-auto Step 1.5 自动调用（当原始描述模糊时）。

核心原则：推导但不猜测。通过引导式提问帮助用户补齐关键信息，最终生成高质量的技术提问草稿。

强制交互规则

详见 hany-common/procedures/interaction_rules.md

质量模式

详见 hany-common/procedures/quality_modes.md

编码约束

读取 hany-common/rules/rules.md，11 条规则全程生效。

概览（必读）

[按需加载] 执行时：

1. 启动阶段：仅读"工作流程"和"Step 0：先想想看"即可开始
2. 执行阶段：进入 Step 时跳读到对应章节
3. 已完成阶段：用摘要替代详细内容

快速参考卡

阶段	核心动作	确认节点
Step 0	先想想看，判断是否需要执行	—
Step 1	接收输入并评估完整度	—
Step 2	判断分类（错误/行为/配置/概念）	—
Step 3	追问循环（含挑战者模式）	每轮 AskUserQuestion
Step 4	生成草稿及持久化	—
Step 5	最终确认	AskUserQuestion

概览工作流程

见上方快速参考卡（按顺序从 Step 0 到 Step 5）。

---

Step 0：先想想看 [进度 5%]

⚠️ 若由 hany-auto 调用，跳过此步（auto 已完成初步思考）。

触发后，先思考再执行。

1. 用户当前的问题是什么？
2. 是否已经足够清晰到可以直接开始 hany-require？
3. 如果不够清晰，追问的方向应该是哪几个？

思考完后输出思路再进入 Step 1。

Step 1：接收输入并评估完整度 [进度 15%]

收到用户描述后，计算歧义评分（详见「歧义评分」章节）：

• 歧义度 < 质量模式阈值 → 跳过追问，直接生成草稿
• 歧义度 ≥ 质量模式阈值 → 进入追问循环

Step 2：判断分类 [进度 25%]

类型	触发条件	必填字段	选填字段
错误类	有报错信息或"不工作"类描述	报错信息、复现步骤	环境、代码、已尝试
行为类	"期望A但实际是B"类描述	期望行为、实际行为	环境、代码
配置类	涉及配置/部署/环境搭建	期望配置、实际配置	环境
概念类	问"是什么/为什么/怎么理解"	困惑点 + 场景	相关代码

不确定分类时默认按「错误类」处理。

Step 3：追问循环 [进度 40-70%]

3.1 概念类：独立追问逻辑

概念类不是补信息，是确认用户理解的边界。先问：

1. "你是遇到了具体问题想解决，还是纯粹想理解原理？"
2. "你是在什么场景下遇到这个困惑的？"

根据回答决定回答方向（解决问题 vs 解释原理），然后直接进入第四步。

3.2 错误/行为/配置类：补信息追问

每次追问最多 2 个问题，先复述用户已说的，再指出缺失点：

• 报错信息 → "你提到了 XX 报错，能把完整错误信息贴一下吗？"
• 复现步骤 → "你说在做 XX 时出问题，具体是从哪一步开始的？"
• 环境 → "你的操作系统和技术栈版本是什么？"
• 代码 → "能把相关代码贴一下吗？"
• 期望 vs 实际 → "你期望的结果是什么？实际输出是什么？"

追问策略：用对比式提问，不要像填表。避免连续问封闭式问题。

信息矛盾处理：当用户新回答和之前信息冲突时，用"你之前说 X，现在说 Y，是改主意了还是我理解错了？"确认。

追问终止条件：

• 歧义度 < 质量模式阈值 → 停止
• 用户表示"就这些了/我不知道更多了" → 停止
• 用户多次回答仍无法说清 → 降低要求，用「最简复现」替代
• 达到质量模式最大轮次 → 停止并告知当前歧义度

多问题处理：用户同时有多个问题 → 先处理第一个，其余标记为「附带问题」。

3.3 追问中的挑战者模式

根据追问轮次自动激活（每个模式只用一次）：

轮次	模式	注入指令	示例
第 4 轮+	反问者	挑战用户的复现步骤或问题框架	"你提到在执行 X 时报错，但 X 不应该触发这个错误。你确定步骤是对的吗？"
第 5 轮+	简化者	找到最简复现路径	"这个报错能用更少的步骤复现吗？最简复现是什么？"

Step 4：生成草稿及持久化 [进度 85%]

追问终止后主动输出草稿（不要等用户要求）。

4.1 草稿模板

根据分类裁剪模板，去掉不适用的区块。模板应包含：分类、标题、已知信息、缺失信息、复现步骤（错误类）、期望/实际行为（行为类）、环境信息、相关代码片段。

4.2 持久化

将草稿写入 docs/hany/questions/YYYY-MM-DD-<主题>.md。

---
date: YYYY-MM-DD
category: 错误/行为/配置/概念
status: draft
ambiguity: {最终歧义度}%
rounds: {追问轮次}
---

{草稿内容}

Step 5：最终确认 [进度 100%]

输出草稿后问用户："这份草稿可以吗？有需要补充或修改的地方吗？"

选项：

1. 可以，直接使用
2. 需要修改
3. 转为正式需求 → 引导触发 /hany:require

根据用户反馈调整，直到用户满意。

---

歧义评分

详见 hany-common/procedures/ambiguity_scoring.md

每轮追问后计算歧义评分。

实体追踪

详见 hany-common/procedures/entity_tracking.md

每轮追问提取关键名词，追踪稳定性。防止概念漂移。

追问原则

1. 每次追问不超过 2 个问题
2. 优先追问必填字段
3. 先复述已说内容，再用对比式提问
4. 用户已经提到的信息不要重复问
5. 信息矛盾时先确认再继续
6. 每轮追问后计算歧义度并展示给用户