SuperAPI AI 工具集

source-driven

编程与开发

查看项目

更新于 10-16 05:50

技能介绍

用途:Source-Driven Development 强调不要依赖训练数据来使用 API,而应阅读真实的权威来源。它适合在实现功能时,确保代码所用 API 与依赖的具体版本一致。

工作流程:

  1. 确认依赖:读取 package.json 或等价的清单文件,获取精确版本,记录任务涉及的每个库的确切版本。
  2. 获取官方文档:为涉及的每个依赖找到对应特定版本(而非 latest)的正确文档 URL,使用 WebFetch 抓取相关 API 页面,提取函数签名、必填参数、返回类型和破坏性变更。若文档不可用或含义不清,则阅读 node_modules/ 中的库源码。
  3. 依据文档实现:只使用抓取到的文档中已确认的 API,严格匹配函数签名(参数顺序、类型、默认值)。能确认的 API 可直接使用;无法核实的需标记 // UNVERIFIED: could not confirm in docs for v{version}。
  4. 引用来源:对不明显或特定版本的 API 用法添加简短注释,如 // Ref: https://docs.example.com/v3/api#method;显而易见调用无需过度注释。

错误处理:文档 URL 返回 404 时,依次尝试 GitHub 仓库 README、node_modules/ 源码;文档中找不到对应版本时,使用最接近版本的文档并标记 // UNVERIFIED: docs for v{closest}, installed v{actual};WebFetch 被阻止或不可用时,改读 node_modules/{pkg}/README.md 或类型定义。

限制:文档缺失或含糊时需回退到源码,无法核实的 API 只能显式标记而非默认使用;具体支持的平台、收费与效果资料暂未提供。