mcpField
A
agent-interview

agent-interview

github.com/scrollmarkAgent 工作流1644 次安装1 天前更新
代码仓库

关于 agent-interview

agent-interview 是规范 Agent 访谈流程的技能,强调明确选项和确认答案。它规定提问轮次、默认值、答案复述,以及执行重要操作前逐步教学的方式。

主要功能

  1. 01提供明确选项的选择题
  2. 02使用原生、MCP 或编号提问方式
  3. 03每轮最多四个问题
  4. 04明确默认值并追问未答选项
  5. 05重要操作前复述答案
  6. 06每次教学一步并安排尝试与确认

适用场景

  1. 01重要操作前收集需求
  2. 02厘清多问题轮次中的模糊回答
  3. 03逐步引导用户完成任务

MCP 相关

若已注册问题 MCP,该技能可使用它;README 未说明此技能自身提供 MCP 服务。

安装

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

$npx skills add https://github.com/scrollmark/social-skills --skill agent-interview

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

详细介绍

Agent 访谈

访谈是一种协议,而不是碰巧会问些问题的对话: 一次只做一个决定,提供可供选择的真实选项,为每件事统一使用一个名称,并在任何高成本操作前复述确认。开放式问题会得到模糊的回答,而模糊的回答之后会被悄悄补成具体内容。

提问

提选择题——带有明确选项的真实问题。使用宿主提供的最高级别方式:

  1. 原生提问工具(例如 AskUserQuestion)。最佳方式——用户自行选择,而且始终可以免费选择“其他”进行自由作答。
  2. 提问 MCP,如果已注册。体验相同,无需原生选择器。
  3. **在消息中列出编号选项。**下方介绍的备用方式——这是可行方案,不是失败。

没有第四级方式;在想出其他办法前,要先明白原因:你的 shell 没有连接终端——没有 tty,也没有 stdin。read 会立即返回,因此提示脚本会卡住,或者悄悄采用一个没人选过的默认值。

编号备用方式

每次只进行一轮,每轮所有问题放在同一个区块中,标签在整轮内保持唯一:

**Q1. Which filing status?**  (pick one · default: a)
   a) Single   b) Married filing jointly   c) Head of household
**Q2. Which apply to you?**  (pick any · default: none)
   a) Dependents   b) Self-employed income   c) Rental income

Reply like `1a 2c`, or say it in words. Anything the options miss, say
plainly and it goes in as-is.

以下每条规则都有其存在的理由,因为宽松的做法会以特定方式出错。

  • 标签在整轮内唯一,而非只在单个问题内唯一。Q1/Q2搭配 a/b/c,能以一种方式解析;每个问题都使用 1) 2) 3),那么一轮有两个问题时,“第二个”立刻就会变得含糊。
  • **每个问题都标明单选还是多选。**如果没有标明,多选回答会被当成单选,其他选项就会在没人注意的情况下被忽略。
  • 为每个问题指定默认值,但仅在其他问题都已回答、且某个问题明显被跳过时采用。整轮都没有回应,不代表同意。
  • **绝不推断未回答的问题。**面对包含三个问题的一轮,“嗯,第一个听起来不错”只回答了其中一个。只重新询问那个问题。
  • 在第一项耗费金钱或时间,或难以撤销的操作前复述确认所有答案——用一行列出每个答案,此时即便解析有误,也不会造成损失。
  • 每轮最多 4 个问题,并保留自由作答的入口。太长的轮次往往只会得到部分回答,而这正是此协议要避免的问题。

统一用语

在发送第一条消息前,先确定面向用户的每个环节名称,并始终使用该名称——如果有人听到同一件事有两个名称,就会以为那是两件事,继而提出无从回答的问题。名称要描述步骤为他们做什么(“检查你的回答”),而不是说明它由什么构成。如果他们问它基于什么运行,就如实回答:不主动提及底层机制,也不隐瞒。

边做边教

**每条消息只讲一步。**一次贴出整段教程,只会变成一份碰巧出现在聊天里的文档:没人会读中间部分,没人会做练习,而你也无从得知他们理解了什么。自己规划好全部内容;每次只展示一个环节。每一步都要包含 TRY——用户实际运行或说出的一项内容;没有它,这一步就只是说教——以及 CHECK,在进入下一步前提出一个真实的选择题。回答错误或缺失,就重新讲解,而不是继续推进。讲解如何获取某样东西前,先检查用户是否已经有了。

反面模式

  • 把五个问题塞进一段话里,寄希望于用户能应付
  • 只问“这样行吗?”——这会引来一个“行”,却无法确认任何事情
  • 复述确认前就开始花钱
  • 仅仅因为工具输出用了另一个词,就在访谈中途给某个事物改名

评论

支持 Markdown