AgentSkillsCN

question-clarify

问题澄清技能。在回答用户问题之前,确保准确理解其真实意图。适用于问题表述模糊、范围不明确、存在多种解读方式的情况。若问题已清晰,或用户明确要求直接作答,则可跳过此步骤。

SKILL.md
--- frontmatter
name: question-clarify
description: 问题澄清技能。用于在回答用户问题前确保理解其真实意图。适用于问题表述模糊、范围不明确、存在多种解读方式。若问题已清晰或用户要求直接回答,可跳过。

问题澄清

定位

本 skill 用于在回答用户问题或处理用户需求前,确保正确理解用户意图。

核心原则

  1. 快速判断:1秒内判断问题是否需要澄清
  2. 最小干预:问题清晰时直接跳过,不浪费用户时间
  3. 精准提问:必要时只问 1-2 个关键问题
  4. 尊重用户:用户说"直接回答"时立即跳过

判断标准

需要澄清的情况

类型示例澄清方向
歧义"怎么优化这个函数?"优化性能?可读性?内存占用?
范围不清"讲一下这个模块"想要概述?详细实现?使用方法?
隐含假设"为什么不工作?"什么不工作?期望行为是什么?
多种解读"能帮我改一下吗?"具体改什么?改成什么样?

无需澄清的情况

  • ✅ 问题具体明确:"函数 compute_reward 的返回值是什么类型?"
  • ✅ 上下文充分:用户已附带代码/错误信息
  • ✅ 用户表态:用户说"先随便看看"、"直接回答即可"

执行流程

code
1. 阅读用户问题
2. 判断是否需要澄清:
   - 清晰 → 本 skill 完成,返回控制权
   - 模糊 → 提出澄清问题
3. 澄清问题限制:
   - 最多 1-2 个问题
   - 提供选项供用户快速选择
4. 获得澄清后,本 skill 完成

澄清问题模板

选项式(推荐,减少用户输入负担):

你的问题可能有几种理解,想确认一下:

  1. 你想了解 X 的原理?
  2. 你想知道如何使用 X?
  3. 你遇到了 X 的问题需要解决?

开放式(当选项无法覆盖时):

想确认一下:你说的"XX"具体是指什么场景?

输出

本 skill 不产生单独输出文档。澄清完成后,调用方可继续后续处理。

注意事项

  1. 不要过度追问:最多 1-2 轮,避免像"审问"
  2. 用选项减轻负担:让用户选择比让用户打字轻松
  3. 保持对话节奏:澄清是为了更快地回答,不是拖延