SuperAPI AI 工具集

known-issue-research

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:在代码修复工作流的技术分析阶段,判断一个已确认的问题是否需要先做外部网络调研,以及如何根据调研结果决定后续步骤。它不替代根因分析,只调整后续步骤的优先级。

前置检查:该技能在 frontmatter 依赖中声明 effective-web-research,加载时需确认其可用;缺失则中止并打印安装命令 npx skills add FuDesign2008/open-skills -g,不做静默回退。

调研路由分诊:在问题存在性确认后立即执行,分三类——内部优先(根因疑似在本仓库,先定位代码,快速检索为可选兜底)、外部优先(涉及具名第三方库/框架及版本,或平台静默失败、嵌套宿主、无代码级嫌疑时,快速检索为主)、混合(外部概念加内部对象,先外部理解概念再做内部根因分析)。不确定时默认内部优先。

已知问题快速检索:触发条件包括平台/原生组件静默失败、嵌套宿主运行时(React Native、Electron、Cordova、WebView-in-App 等)而前端逻辑正确、调用链完整参数正确日志有执行但运行不生效。执行 WebSearch,查询形如“症状关键词 + 平台/框架 + 年份”,覆盖 StackOverflow、GitHub Issues、官方文档;涉及具名第三方库或症状与平台强相关时,并行检查上游依赖的 Changelog/Release Notes/Issues 是否已有修复版本。结果处置:找到已知案例且根因明确则输出结论并跳到影响评估步骤;找到上游修复版本则进入上游评估步骤;仅有相关讨论则作为根因步骤参考;无结果则静默跳过继续根因分析。

性能模式变体:当引用工作流为性能分析时,本节作为已知性能模式快速检索,额外触发条件为异常无法归入已知性能模式表、疑似框架/库性能缺陷或限制,查询形如症状 + 框架/库 + 版本 + 年份。

行业级问题评估:可选悲观分支,当根因指向平台/语言/协议/标准的硬限制且无明显应用层绕行方案时,检索是否为业界公认问题、主流框架如何处理、是否存在可行绕行。结果处置:公认硬问题且无可行方案则输出评估报告并暂停等待用户决定;有限但有绕行则列为候选方案继续;非行业级可修复则继续影响评估步骤。

检索纪律:所有 WebSearch 遵循 effective-web-research,先做其 Step 0 分诊,再遵循权威优先、时效检查、交叉验证、跳过内容农场等准则;用户要求严谨时切换严格模式并产出报告,检索前应阅读该技能当前文档而非凭记忆。

集成说明:引用工作流需在 frontmatter 依赖中声明本技能,启动缺失即中止;引用行需说明占位步骤编号映射及本技能各节插入位置;语义变体保留在各自工作流体内。

限制:本技能为内部共享技能,具体步骤编号以引用工作流为准,不硬编码;资料未提供独立界面、收费或平台支持信息。