用途
该技能用于规范 AI 智能体在回合结束时与用户的协作方式:当智能体被用户阻塞,或下一步需要用户操作时,在回复末尾以简短、编号的“What I need from you”段落列出用户需要做的具体动作。如果不需要用户做任何事,则明确写出“Nothing needed from you right now”,避免用户主动询问。
主要能力
- 具体化请求:每个编号项只包含一个具体动作,说明要做什么、在哪里做(哪个网站、应用、文件或联系人)、以及需要回传什么结果。例如应写“登录 CommBank NetBank 并将 2026 年 1 月至 6 月导出为 CSV,然后放入 inbox/”,而不是“我需要银行数据”。
- 优先级排序:如果有多个请求,把最快或最阻塞的一项放在最前面,并说明等待期间智能体会继续做什么。
- 请求不埋没:要求永远不要把对用户的请求埋在冗长更新的中间,该段落必须放在回复最后。
- 安全性要求:永远不向用户索要秘密值,而是要求用户将其粘贴到仪表盘或环境变量中,然后确认已设置。
- 请求分类:每项请求需标注类型,分为“do”(用户需在智能体无法访问的地方操作,如仪表盘、登录、2FA、支付页面)、“decide”(只有用户能做的选择,需提供选项和智能体的建议,要求用户回一个词)、“approve”(智能体可以做,但会花钱、删除数据、发布或触碰生产环境,需说明成本或不可逆后果,然后等待用户明确回复“yes A4”;自动批准模式或之前的“继续”不算数)。
- 拒绝处理:用户拒绝或跳过请求算作一种回答,需在日志中标记为 declined,除非情况发生变化,否则不再重复询问;若再次询问需说明变化。
使用方式
该技能在每次使用它的回合中,还会更新项目根目录下的 prds/what-i-need-from-you.md 文件。若 prds/ 文件夹或文件不存在则创建。具体步骤:
- 为每个新请求分配下一个编号(A1、A2……),编号永不复用,以便用户回复“A3 done”。
- 将新请求添加到 Open 表格:编号、类型、动作、位置、回传内容、步骤链接、请求日期。
- 当用户报告完成或智能体确认完成时,将该行移到 Done 并记录日期;被拒绝的请求也移到 Done,标注“declined”及原因。
- 在该部分顶部添加 Session log 条目,即使没有变化也要添加,格式为:日期时间、提示短名、Asked(新增请求编号或“none new”)、Closed(关闭的请求编号或“none”)、Changed(一行说明该回合做了什么)。
回复中的“What I need from you”列表与 Open 表格需使用相同编号保持同步。文件布局顺序为:标题及一行使用说明、## Open、## Done、## Session log(最新在前)。如果项目还有任务文件(如 task-repos.md),需将其“What I need from you”部分放在该文件最前面,并链接到日志。
适用场景
适用于 AI 智能体与用户进行多轮协作、需要用户介入才能推进任务的场景,尤其是涉及需要用户登录操作、做决策或批准高风险操作的工作流。
限制
该技能仅定义了请求的呈现格式、分类和记录方式,不包含具体业务逻辑或自动化执行能力。对于秘密值处理有明确限制:不得索要秘密值,只能引导用户自行设置并确认。批准类请求必须等待用户明确回复,自动批准模式或之前的笼统同意无效。其余关于价格、平台支持等事实暂未提供。