SuperAPI AI 工具集

research-spike

写作与研究

查看项目

更新于 10-15 21:08

技能介绍

用途:在正式采用某个库、API、架构或服务商之前,执行一次限时、结构化的研究调研(research spike),最终给出带权衡分析的推荐结论,并记录到 docs/research/ 目录,全程不修改生产代码。

主要能力:按四个阶段推进。第一阶段界定问题:用一句话重述研究问题,列出至少两个待比较选项,定义决策标准(成本、复杂度、维护性、性能、安全、兼容性),并确定文档来源。第二阶段研究:并行启动只读的 Explore 子代理,每个选项或主题一个,通过 Context7 获取最新文档,阅读官方文档、源码与示例,识别能力、限制、失败模式、维护状态与社区健康度,并记录文档与现实的预期差距。第三阶段比较与推荐:按决策标准构建对比矩阵,给出明确推荐及理由,列出各选项的权衡与风险,并识别采用后的后续实现问题。第四阶段撰写发现:写入 docs/research/<date>-<slug>.md,包含日期、决策、状态、问题、选项对比、对比矩阵、推荐、后续事项与来源。

使用方式:命令为 /research-spike <question> [--options "A, B, C"] [--time-box 2h]。涉及库、框架、SDK 的问题需使用 Context7,命令为 npx ctx7@latest library "<library name>" "<research question>" 和 npx ctx7@latest docs <libraryId> "<specific question>"。

适用场景:被要求“research”“compare options”“evaluate a library”“spike”等时使用。

限制:仅做研究,不做生产代码改动;库/框架/SDK 问题必须用 Context7,不依赖训练数据;即使结论是“不采用”也要记录发现;对采纳的推荐需建立后续实现 issue;研究须限时,若在时限内无法回答,需记录已知与未知内容。其他细节暂未提供。