SuperAPI AI 工具集

vague

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:vague 用于把模糊或含糊的需求转化为精确、可执行的规格说明,通过假设驱动的提问完成澄清。适用于含糊的功能请求(如“加个登录功能”)、不完整的缺陷报告(如“导出坏了”)、描述不足的任务(如“让应用更快”)。若需战略/规划盲点分析,使用 unknown 技能;若需内容与形式的重新框定,使用 metamedium 技能。

核心原则:把可能的解释作为选项呈现,而不是提开放式问题。每个选项都是关于用户真实意图的可检验假设。例如不问“你想要哪种登录”,而给出“OAuth / 邮箱+密码 / SSO / 魔法链接”供选择,降低认知负担。

流程:第一阶段捕获并诊断,逐字记录原始需求,识别不明确、需假设和留待解释之处。第二阶段迭代澄清,使用 AskUserQuestion 解决歧义,每次调用最多批量 4 个相关问题,每个选项是一个假设;总问题数上限 5-8 个,当关键歧义解决、用户表示“够好了”或达到上限时停止。第三阶段给出前后对比摘要,包含原始请求、澄清后的目标、范围、约束、成功标准以及决策表。第四阶段询问是否将澄清后的需求保存到文件,默认位置为 requirements/ 或项目合适目录。

歧义类别包括:范围(所有用户/仅管理员/特定角色)、行为(静默失败/显示错误/自动重试)、接口(REST API/GraphQL/CLI)、数据(JSON/CSV/两者)、约束(<100ms/<1s/无要求)、优先级(必须有/最好有/未来)、规则。

规则:用假设而非开放式问题;不做假设,要问不要猜;保留原意,只细化不转向;最多 5-8 个问题;批量相关问题;始终展示前后变化。限制:资料未提供具体安装命令、收费或平台信息。