【免费下载链接】library-skills
Library Agent Skills
library-skills 是一个开源命令行工具:它自动扫描你项目里已安装的 Python / Node.js 依赖库,把库作者随每个版本发布的官方 AI 技能(Agent Skills)以符号链接方式接入 AI Agent 的技能目录,让 AI 写代码时始终参考最新、最权威的用法,告别旧 API 和"一本正经的幻觉"。
AI Agent 为什么总爱写"过时"的代码?
大语言模型(LLM)再聪明,也是被"某个时间点之前的数据"喂大的:
- 训练数据有截止日:库的最新版特性,模型压根没见过;
- 训练语料里旧模式扎堆:网上流传最多的示例代码,往往来自旧版本;
- 结果就是:Agent 不知道新特性怎么用,还坚持使用已弃用的旧 API,甚至编造不存在的函数。
问题不在 Agent 不努力,而在于它手里没有最新的说明书。
官方库技能(Library Skills)是什么?
越来越多的开源库(如 FastAPI、Streamlit)开始在自己的安装包内直接附带Agent Skills(即SKILL.md文件),内容是该库的最佳实践与最新 API 用法说明。这些技能与库的版本同步发布:你升级库,说明书就同步升级。
而 library-skills 要做的,就是把这些"藏在依赖里"的官方技能一键接入你的 AI Agent:
- 扫描
pyproject.toml/package.json中声明的依赖; - 在你的
.venv或node_modules中查找已安装库附带的技能; - 在项目的
.agents/skills(或.claude/skills)下创建相对符号链接指向这些技能; - 之后升级库,符号链接自动指向新版技能,AI 永远拿到最新文档。
核心实现可以参考 scanner.py 中的依赖扫描逻辑、installer.py 中的符号链接安装逻辑,以及 python_env.py 中的环境检测逻辑。
一键安装官方库技能:两条命令快速上手
Python 项目
在项目根目录执行:
uvx library-skillsNode.js 项目
npx library-skills运行后工具会交互式地询问你:要安装哪些新技能、装到哪个目录。默认选中.agents/skills;如果项目里已存在.claude/目录,会同时选中.claude/skills。
💡 Claude Code 用户注意
Claude Code 只认.claude/skills目录。交互式安装时请勾选.claude/skills;如果要在脚本或 CI 中非交互安装,直接加参数:
uvx library-skills --claude更多使用细节见 docs/use/index.md,完整的 CLI 参数参考见 docs/reference.md。
技能状态一览表:一眼看懂"装没装、对不对"
library-skills会输出一张状态表,常见状态如下:
| 状态 | 含义 |
|---|---|
new | 发现的新技能,尚未安装 |
up to date | 已安装且指向最新位置 |
broken | 符号链接目标已不存在 |
outdated | 技能还在,但链接指向了旧位置 |
orphaned | 对应的包或技能已被卸载 |
name mismatch | 目录名与技能名不一致 |
hand-authored | 手写的技能目录(不会被工具管理) |
再次运行同一条命令即可自动修复错位链接、清理失效链接;它只动自己管理的符号链接,不会碰你手写的技能目录,非常安全。
进阶技巧:自动检查、非交互修复与 JSON 输出
- 只检查、不改动:
uvx library-skills --check,发现漂移时退出码为 1,方便接入 CI; - 非交互自动修复:
uvx library-skills --yes,跳过所有确认提示; - 机器可读输出:
npx library-skills list --json,适合自动化脚本二次开发。
配合 pre-commit 钩子,还能在提交时自动检查技能与依赖是否漂移(配置示例见 docs/use/index.md 的 Pre-Commit Hook 一节)。
项目结构速览
| 模块 | 说明 |
|---|---|
| src/library_skills/cli.py | CLI 入口与主流程 |
| src/library_skills/scanner.py | 扫描已安装库中的技能 |
| src/library_skills/installer.py | 技能安装、修复与移除 |
| src/library_skills/python_env.py | 检测 .venv / node_modules 环境 |
| ts/src/cli.ts | TypeScript 版 CLI 实现 |
| src/library_skills/tool_skill/SKILL.md | 工具自带的技能说明文档 |
Python 与 TypeScript 两个版本并行维护,各生态开发者无需安装对方运行时即可使用。
总结:给 AI 一份永远最新的说明书 📚
AI Agent 写旧 API 的根源是信息过期,而 library-skills 的解法非常干净:让库作者把官方说明书随版本一起发布,再用一条命令把说明书自动接入 Agent。依赖升级,技能自动跟着升级——从此 AI 用的都是"原版最新"的库用法。
- Python 项目:
uvx library-skills - Node.js 项目:
npx library-skills - Claude Code 用户加上:
--claude
想深入了解如何为库编写自己的技能,可参考 docs/create/index.md 与项目关于页 docs/about/index.md。
【免费下载链接】library-skills
Library Agent Skills
相关推荐
为什么AI写的Three.js代码总是有坑?threejs-skills 3D技能库完整指南
为什么AI写的Three.js代码总是有坑?threejs skills 3D技能库完整指南 你是否遇到过这种情况:让 AI 写一个 Three.js 3D 场
Salesforce官方AI技能库sf-skills是什么?246个Agent Skills新手完全指南
Salesforce官方AI技能库sf skills是什么?246个Agent Skills新手完全指南 sf skills 是 Salesforce 官方出品
docker stack ps 详解:在 Swarm 集群中查看与排查 Stack 任务
docker stack ps 详解:在 Swarm 集群中查看与排查 Stack 任务 docker stack ps 是 Docker CLI 中用于列出指
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考