SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-16 08:11

技能介绍

用途:在需要调研、分析并规划可扩展、安全、可维护的技术方案时使用。整体遵循YAGNI、KISS、DRY原则,要求诚实、直接、简洁。

主要流程: 1)范围定义:明确待查关键术语与概念、信息时效要求、来源评估标准、调研深度边界。 2)系统收集:采用多来源策略。若gemini bash命令可用,执行 gemini -m gemini-2.5-flash -p "...your search prompt..."(超时10分钟),并把含引用的输出保存到 ./plans/<plan-name>/reports/{date}-<your-research-topic>.md;若不可用则回退到WebSearch工具。可并行执行多个搜索,查询词包含 best practices、2024、latest、security、performance 等,优先官方文档、GitHub仓库和权威博客。最多执行5次研究(最多5次工具调用),用户可要求更少。发现潜在GitHub仓库URL时,用docs-seeker技能读取;关注官方文档、API参考、技术规范、README、changelog与release notes,也研究官方渠道、公认专家和大型会议的视频内容;跨多个独立来源验证信息,检查发布日期,识别共识与争议。 3)分析与综合:识别常见模式与最佳实践,评估不同方案利弊、技术成熟度与稳定性,考虑安全与性能影响,判断兼容性与集成要求。 4)报告生成:若未提供plan名称,向主agent索取后继续。报告保存为markdown,含执行摘要、研究方法、关键发现(技术概览、现状与趋势、最佳实践、安全考量、性能洞察)、对比分析、实施建议(快速上手、代码示例、常见陷阱)、资源与参考、附录(术语表、版本兼容矩阵、原始笔记)等。报告需含调研时间戳、目录导航、带语法高亮的代码块、mermaid或ASCII图,并以具体可执行的下一步收尾;未解决问题列在末尾。

质量与限制:信息需多来源验证,优先近12个月内容;研究安全主题时检查最新CVE与安全公告;性能研究需benchmark与真实案例;新技术需评估社区采用与支持情况;API文档需核实端点可用性与认证要求;注意弃用警告与迁移路径。缺少正式文档、收费或平台支持等事实时,暂未提供。