SuperAPI AI 工具集

clarifying-scenarios

设计与创作

查看项目

更新于 10-16 00:31

技能介绍

用途:这是 microsoft/github-copilot-modernization 下的一个技能,用于在现代化/重写请求进入拆解之前,评估用户提示词是否包含足够的场景上下文。资料指出,前端重写常因提示词缺少目标组件库、截图或合规要求而无声失败;该技能在拆解前捕捉这些缺口。

主要能力:依据前端、后端、通用三套 kit,对原始用户提示词与项目事实进行匹配;计算确定性的清晰度评分;一次性生成全部澄清问题并以单个 JSON 文件(clarification-questions.json)落盘,不做分组、不做多轮交互;外部工具把 JSON 渲染为 webview 或 markdown 供用户作答,每个选择类问题都附带 “Other” 自由文本选项;写出供 Foundation/Design/Plan 智能体使用的标准 clarification.md。

使用方式:技能读取协调器提供的 userInput、classification、project_facts 等输入。状态完全由磁盘驱动且可重入:若 clarification.md 已存在则返回 READY;若 clarification-answers.md 的 front-matter 为 submitted 则读取并进入后续步骤;若仅有问题 JSON 则返回 NEEDS_INPUT 提醒用户提交。首选通过 appmod-rearchitecture-clarify 与 appmod-rearchitecture-open-clarification 工具对交付问题集并打开作答界面;工具不可用时(如 CLI 运行)回退为自行写出问题 JSON。决策令牌包括 READY、NEEDS_INPUT、BLOCKED。

适用场景:前端或后端现代化重写前的需求澄清,尤其适合提示词信息不全的情况。

限制:若分类为 direct 或 fix_bug,则直接以最小 clarification.md 返回 READY,不做评分;答案只能从已提交的 clarification-answers.md 读取,不得从问题 JSON 中读取;该技能不提供网页版交互问答,渲染由外部工具负责;具体收费、价格、平台与效果资料未提供。