添加第三方依赖Skill add-dependency

---

name: add-dependency description: 遵循版本目录和审批流程，向项目添加新的第三方依赖。

添加第三方依赖

此技能概述了向项目有效添加新依赖的必要步骤。

工作流程

1. 验证必要性：

   • 目标：确保该依赖是绝对必要的。
   • 操作：除非没有可用的定制解决方案，或者手动实现能显著帮助项目，否则避免添加新的第三方依赖。
   • 操作：在添加任何新的第三方依赖之前，必须获得用户批准。解释为什么需要它以及考虑了哪些替代方案。

2. 查找最新版本：

   • 目标：使用最新的稳定版本。
   • 操作：执行网络搜索以确定库的最新稳定版本。
   • 示例：search_web(query="retrofit 最新版本")

3. 更新版本目录：

   • 目标：集中管理依赖。
   • 操作：将依赖添加到 gradle/libs.versions.toml。
   • 格式：

     [versions]
     libraryName = "1.2.3"
     
     [libraries]
     library-artifact = { group = "com.example", name = "library-artifact", version.ref = "libraryName" }
     

4. 同步与构建：

   • 目标：验证依赖是否正确解析。
   • 操作：运行构建或同步命令，以确保新依赖不会破坏构建。
   • 命令：./gradlew assembleDebug（或相关任务）。

指导原则

• 审批优先：在获得用户确认之前，不要修改文件（除非在完全自主模式下，且此操作已预先批准）。
• 禁止硬编码：切勿将版本号直接放入 build.gradle.kts 文件中。始终使用版本目录（libs.versions.toml）。