SuperAPI AI 工具集

neo-clarification

智能体与模型

查看项目

更新于 10-15 20:06

技能介绍

用途:当用户给出含糊、带情绪、零散或基于截图的抱怨式需求时,该技能将其翻译为清晰、结构化的系统规格说明,采用“反转与生成”模式。

主要能力:分为感知、推理、行动三阶段。感知阶段从文本、截图或日志中提取信息,过滤情绪与指责,区分客观事实与用户期望,并识别受影响的系统边界(如前端渲染、网络 API、数据库状态、权限组)。推理阶段先读取外部分析指南 5w1h-framework.md,用 5W1H 框架重建上下文,提出根因假设,找出缺失信息并准备澄清问题。行动阶段读取 clarification-template.md,生成繁体中文(台湾)的“需求翻译与澄清报告”,包含上下文还原、用户故事(格式为“身為… 我想要… 以便於…”)、系统需求与假设、以及 2 至 10 个礼貌精确的开放问题。

使用方式:按协议执行,并在输出前用非交互式脚本自检:uv run skills/neo-clarification/scripts/validate-requirements.py -i <path_to_saved_report>,或人工确认各章节齐全且问题数量在 2 到 10 之间。

适用场景:处理用户投诉、UI 异常反馈、截图报错、需求描述不清等需要澄清与规格化的场合。

限制:沟通上保持同理中立,不认同系统“坏了”等说法;严禁猜测,不虚构用户未暗示的功能,缺失信息应通过提问获取。报告语言固定为繁体中文(台湾)。