ask-me

name	ask-me
description	当用户说"你来问我"、"ask me"时触发。第一次创建方案或设计时触发。修改文件后用于理解变更意图。关键：当你（AI）感到困惑、不确定如何执行、或指令有歧义时——不要猜测，立即调用此skill。当你觉得方案有多种执行的可能，你从中挑选了一种的时候，立刻调用此skill确认你的选择是否正确。

Ask Me Skill

系统化提问以确保执行前达成共识。

提问原则

• 首轮提 3–20 个问题，后续轮次持续提问直到对齐
• 检测到矛盾时立即指出，不要等到后面
• 用户给出明确确认（"对"、"就是这个"）时推断为已对齐；回应模糊时显式询问"我们是否对齐？"

AI 困惑时如何提问

1. 说明困惑点："我不确定 X"
2. 如有 2–3 种明显不同的解读，列出并让用户选择
3. 如缺少关键信息，直接问

反模式：选一种解读先执行，再问"这是你想要的吗？"——浪费时间且可能造成不必要的改动。

停止提问的条件

• 用户给出清晰、一致的确认
• 无重大歧义残留
• 所有关键设计分支已探明

复杂场景：对齐后输出 Review Summary

适用于：多文件修改（3+ 个文件）、架构级变更、新功能实现、有设计影响的重构。

跳过的情况：简单澄清、单文件编辑、范围明确的 bugfix、配置变更。

## Review Summary

**理解：** [一句话概括要做什么]
**关键决策：** [决策列表]
**约束条件：** [约束列表]
**下一步：** [行动项]

工具：AskUserQuestion

每次调用可并行提 1–4 个问题，每个问题 2–3 个选项（自动附加"其他"）。

参数	说明
question	问题文本，以问号结尾
header	最多 12 字符的标签
options	2–3 个选项，含 label 和 description
multiSelect	true = 多选，false = 单选
preview	可选，仅单选支持，展示 ASCII 图/代码对比

用 AskUserQuestion 的场景：从明确选项中选择、多个相关决策、需要可视化对比。

用文字提问的场景：开放探索、单一简单确认。

示例：并行提问

AskUserQuestion(
    questions=[
        {
            "question": "日志库用哪个？",
            "header": "日志",
            "options": [
                {"label": "loguru", "description": "现代简洁，样板代码少"},
                {"label": "logging", "description": "标准库，零依赖"},
                {"label": "structlog", "description": "结构化日志，适合生产环境"}
            ],
            "multiSelect": False
        },
        {
            "question": "测试框架用哪个？",
            "header": "测试",
            "options": [
                {"label": "pytest", "description": "功能丰富，生态完善"},
                {"label": "unittest", "description": "标准库，无额外依赖"}
            ],
            "multiSelect": False
        }
    ]
)