SuperAPI AI 工具集

doc-lookup

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:在判断缺陷结论前,核实关于库、框架或 API 实际行为的说法,例如某框架是否默认包含某种防护、某 ORM 是否自动参数化查询、某函数是否校验输入等。

主要能力:通过脚本先查询 Context Hub(chub)中经过整理、带版本信息的文档,若 chub 没有该库则回退到 Context7,返回带推荐来源与推荐 ID 的结果,并可获取文档片段与代码示例。

使用方式:SKILL_DIR 由编排器注入,用于拼接辅助脚本路径。第一步搜索库:node "$SKILL_DIR/scripts/doc-lookup.cjs" search "<library>" "<what you need to know>",例如 node "$SKILL_DIR/scripts/doc-lookup.cjs" search "prisma" "SQL injection parameterized queries"。第二步获取文档:node "$SKILL_DIR/scripts/doc-lookup.cjs" get "<library-or-id>" "<specific question>",例如 node "$SKILL_DIR/scripts/doc-lookup.cjs" get "prisma/orm" "are raw queries parameterized by default"。可选参数:--lang js|py 指定语言变体,--source chub|context7 强制指定来源。

适用场景:任何影响缺陷判定的库行为断言,需要引用文档证据时。

限制与规则:仅在有具体待核实断言时查询,不要对代码库中每个库都推测性拉取文档;每个断言只查一次,不要连续发起多次搜索;若 API 失败或无有用结果,应明确说明“无法从文档核实,基于代码分析继续”;引用时注明来源,如“Per Express docs: [quote]”或“Prisma docs confirm that $queryRaw uses parameterized queries.”。其他收费、平台支持等信息暂未提供。