SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-16 02:12

技能介绍

用途

Research 是一个技术研究方法论技能,用于系统性地调研技术主题并产出结构化报告。它强调遵循 YAGNI、KISS、DRY 原则,要求研究过程诚实、直接、简洁。

主要能力

该技能将研究过程划分为四个阶段:

  1. 范围定义:识别待调查的关键术语与概念,确定信息的时效要求,建立来源评估标准,设定研究深度边界。
  2. 系统性信息收集:采用多来源策略。优先检查 gemini bash 命令是否可用,若可用则执行 gemini -m gemini-2.5-flash -p "...your search prompt..."(超时 10 分钟),并将输出(含所有引用)保存到 ./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md;若不可用则回退到 WebSearch 工具。可并行运行多个搜索,构造精确查询词(如包含 "best practices"、"2024"、"latest"、"security"、"performance"),优先官方文档、GitHub 仓库和权威博客。发现潜在 GitHub 仓库 URL 时,使用 docs-seeker 技能读取。进行交叉引用验证,核对发布日期,识别共识与争议。
  3. 分析与综合:识别常见模式与最佳实践,评估不同方案的优缺点,判断技术成熟度与稳定性,识别安全影响与性能考量,确定兼容性与集成要求。
  4. 报告生成:输出结构化 Markdown 报告,保存至 ./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md。若未提供 plan 名称,需向主 agent 索取后继续。

使用方式

该技能以方法论形式指导研究流程。执行时需注意:最多执行 5 次研究(最多 5 次工具调用),用户可能要求更少,须严格遵守。报告结构包含:执行摘要、研究方法(来源数量、材料日期范围、关键搜索词)、关键发现(技术概述、现状与趋势、最佳实践、安全考量、性能洞察)、对比分析、实施建议(快速入门指南、代码示例、常见陷阱)、资源与参考(官方文档、推荐教程、社区资源、延伸阅读)、附录(术语表、版本兼容矩阵、原始研究笔记)。

适用场景

适用于需要系统性技术调研并产出可操作报告的场景,例如评估新技术、调研安全主题、性能优化研究、API 文档核实等。

限制

  • 最多执行 5 次研究(最多 5 次工具调用)。
  • 报告需保存到指定路径,依赖 plan 名称。
  • 优先使用 gemini bash 命令,不可用时回退 WebSearch。
  • 报告写作时牺牲语法以换取简洁。
  • 报告中需列出未解决问题。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。