mcpField
A
antfu-query

antfu-query

github.com/antfuAgent 工作流6.0k13 次安装2 天前更新
代码仓库

关于 antfu-query

用于访谈用户的技能,将决策整理为分支设计树,并分轮提问,帮助 Agent 在行动前澄清需求。它要求先解决尚未确定的选择,并在结束时总结共识而不擅自执行。

主要功能

  1. 01将决策整理为设计树
  2. 02通过交互式工具提问
  3. 03提供具体选项及权衡
  4. 04每轮后重新计算待问问题
  5. 05总结决策但不执行

适用场景

  1. 01澄清软件变更的需求
  2. 02按顺序处理相互依赖的设计选择
  3. 03在实施前达成共识

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/antfu/skills --skill antfu-query

安装后在 Claude Code 中输入/antfu-query确认已加载。

详细介绍

查询

不断采访用户,直到双方达成共识。将这段过程梳理为一棵设计树:每项决策都应分支出依赖于它的决策。

使用提问工具提问

通过 Agent 的交互式提问工具向用户提出每个问题(例如 Claude Code 中的 AskUserQuestion,或其他 Agent 中的同等工具;如果该工具是延迟加载的,请先加载)。不要在回复中以纯文本形式提出问题。

  • 每个问题提供 2–4 个具体且有明显区别的选项,并简要说明取舍。
  • 将你推荐的答案放在首位,并标注 (Recommended),以便用户选择该项即可接受你的建议。工具会自动提供“其他”选项供用户自由作答;不要自行添加。
  • 标题要简短。只有选项之间并非互斥时,才使用多选。
  • 每轮将当前所有待决问题合并为一次调用,数量不超过工具每次调用的上限(Claude Code 中为 4 个)。如果待决问题更多,先问阻碍最大的,其余问题留到下一轮。
  • 提问时,应让推荐选项成为自然的“是”选项。

轮次

分轮梳理这棵树。待决项是指前置条件均已确定的所有决策:也就是无需猜测尚未听取的答案、现在即可提出的问题。每轮一次性提出所有待决问题,然后等待用户作答后再进入下一轮。

  • 每轮回答都会改变这棵树:已确定的决策会向外延展待决项,并解除依赖问题的阻碍。重新计算待决项,再提出下一轮问题。
  • 如果某个问题的答案取决于本轮尚未确定的另一个问题,则该问题应留到后续轮次。
  • 如果 Agent 没有提问工具,则改用纯文本:为问题编号,列出选项,并注明每个问题的推荐答案。

事实与决策

查明事实是你的职责,不是用户的。需要了解环境中的事实(文件、代码、工具、文档)时,自己去查找,或派遣一个使用全新上下文窗口的子 Agent 去查找。不要向用户询问你本可以自行查明的信息。

不要因此停下来:正在进行的探索属于尚未确定的前置条件,因此只有依赖该探索的问题才需要等待。其余待决问题现在就可以提出。决策由用户决定:逐项询问,并等待用户回答。

完成

当待决项为空时,本次会话即告完成:设计树中的所有分支都已梳理完毕,没有任何未明说的假设。用简短列表总结已确定的决策,在用户确认双方已达成共识之前,不要据此采取行动。

评论

支持 Markdown