技能介绍

解决的问题

工程师在排查 Perl 依赖或评估某个模块是否适合自己的项目时，常要在 CPAN 上来回切换：先看包的元数据、再看 README 里的用法示例，还要确认依赖关系。这个过程依赖多个网页和不同 API，参数规则也不统一，无法在对话流程里直接复用。

核心能力与工作方式

这个技能把 CPAN 包信息查询拆成三个明确工具函数，全部位于 scripts.tools 下：

get_readme_from_cpan：获取包 README 和用法示例，支持指定版本与是否包含示例。
get_package_info_from_cpan：获取包基本信息与依赖，可按需带上开发/测试依赖。
search_packages_from_cpan：按关键词搜索包，控制返回数量。

运行流程遵循固定路由层：先检查密钥；再按意图选择工具；随后提取参数；最后用关键字参数调用函数。例如：scripts.tools.search_packages_from_cpan(query="lwp", limit=20)。工具返回的是 dict，核心字段包括 result["raw"]、result["success"]、result["message"]，需要整理后再呈现给用户。

适用边界与注意点

使用前必须配置 API 密钥：若 scripts.config.settings.api_key 为空，先用 AskUserQuestion 向用户询问，再调用 scripts.config.set_api_key(api_key) 保存。密钥缺失时禁止自行搜索或编造数据。参数不完整时，同样通过 AskUserQuestion 追问。工具只负责调用 API，不做联网搜索之外的猜测，也不替代官方仓库的最终确认。