Hany Question

编码约束

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

概览（必读）

[按需加载] 执行时：

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

快速参考卡

概览工作流程

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

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

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

触发后，先思考再执行。

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

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

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

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

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

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

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

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

3.1 概念类：独立追问逻辑

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

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

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

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

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

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

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

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

追问终止条件：

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

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

3.3 追问中的挑战者模式

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

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

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

4.1 草稿模板

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

4.2 持久化

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

---