SuperAPI AI 工具集

user-input-protocol

智能体与模型

查看项目

更新于 10-15 23:43

技能介绍

用途:为智能体在决策点请求人工输入提供结构化格式,避免智能体替开发者做假设,确保提问包含足够上下文,并为无法直接提示用户的子代理提供暂停与恢复模式。核心原则是尊重开发者判断,代理在应询问时绝不擅自决定。

主要能力:需要人工输入的决策包括业务规则歧义、架构权衡、范围问题、破坏性操作;不需要的包括有唯一正确答案的实现细节、项目约定覆盖的格式命名风格、需求明确时的测试结构。检查点格式为 AWAITING_USER_INPUT,包含 Context(为何提问)、Decision needed(一句话问题)、Options(2-4 个具体选项,每个含含义与影响)、Recommendation(建议或“无建议”)。

使用方式:遇到判断决策立即停止该决策路径,不猜测、不选“最可能”选项。子代理需先保存状态(任务、创建或修改的文件、已完成分析、阻塞决策、可立即继续的上下文),保存位置依运行环境而定,如任务元数据、临时 JSON 文件或 MCP 记忆工具,然后输出检查点并停止,由编排器或主对话呈现问题并带答案恢复。恢复时读取已存状态、确认文件与上下文、应用决定、从停止处继续,不重复分析。

流水线模式:将决策分为可由质量门禁解决(从不询问)、需判断(批量到下次人工评审)、阻塞(立即暂停)三类;检查点可加 Urgency 字段:blocking、next-review、informational。多个相关决策应合并为一个编号检查点。

限制:独立模式下为建议性,由代理自我约束;流水线模式下为结构性,会写状态并暂停。选项必须是真正不同的路径,不能是同一方案的不同配置。资料未提供具体安装命令以外的依赖细节;缺失依赖可用 npx skills add jwilger/agent-skills --skill tdd 安装。