SuperAPI AI 工具集

kf-g-dependency-library-selection-policy

编程与开发

查看项目

更新于 10-16 00:24

技能介绍

用途:在仓库中新增、替换、评估或审查第三方库与包依赖时使用,帮助统一依赖选型标准。

主要能力:优先选择可靠性与持续维护前景好的依赖;先确认标准库、现有依赖、所用框架官方功能是否已足够;新增依赖时控制在与用途必要且充分的范围内。优先采用微软、Meta、Google、Apple、Amazon、Cloudflare、OpenJS Foundation 等可信组织或厂商提供的依赖,所用框架或运行时的官方包,仓库已采用且维护状态良好的依赖,以及在该用途上可称为事实标准的广泛使用库。

基本避免:个人开发者单独维护的库、GitHub stars 少于 1000 的库、近期维护与 issue 响应及发布频率弱的库、仅替代琐碎处理的小型便利库、依赖树庞大且对用途过度的库。

例外条件:个人开发或 stars 不足 1000 时,若该用途被视为事实标准、主要框架或官方文档及大型项目有采用案例、不存在替代的官方或大厂库、自行实现反而显著增加维护性、安全性、兼容性风险,则可作为候选。例外采用时,采用理由(positive Why)写入 commit log;代码注释只写拒绝其他方案或防止误改的 Why not。示例:// HEIC 转换に公式の軽量実装はなく、自前実装へ戻すとフォーマット差分の保守コストが増えるため sharp を使う。\nimport sharp from "sharp";

调查步骤:确认标准功能、现有依赖、官方 API 能否替代;确认包提供方是组织还是个人;GitHub stars 是否达到 1000 以上;最终发布、issue、pull request、安全公告状态;主要项目或官方文档的采用实绩;依赖树、打包体积、许可证是否与用途相符。stars、维护状况、采用实绩会变化,新增依赖判断时应确认当前信息。

评审要点:是否把官方功能或现有依赖可完成的事变成新依赖;是否优先可信厂商或官方包;是否采用个人开发或 stars 不足 1000 的依赖;例外采用是否有事实标准依据;例外采用是否在 commit log 留下采用理由;例外采用是否在实现处留下 Why not 注释。若依赖只能从 package.json 等无法写注释的文件看到,则在直接使用该依赖的实现处留下 Why not,采用理由写入 commit log。

限制:资料未提供具体平台、收费、价格或效果信息。