SuperAPI AI 工具集

tiangolo-library-skills

编程与开发

查看项目

更新于 10-15 22:34

技能介绍

用途:让 AI 编程智能体按库的预期方式使用库,并始终使用最新版本的模式,避免过时或弃用写法。库(如 FastAPI、Streamlit)在每次发布中内嵌官方 AI 技能,library-skills 会发现已安装的这些包,并把它们的技能以符号链接接入项目的 .agents 目录;升级库时技能随之自动更新。

主要能力:扫描项目已安装依赖(当前虚拟环境或 node_modules);找出在 agentskills.io 发布自身技能的库;提示选择要安装的技能;在 .agents/(以及可选的 .claude/skills/)下创建指向已安装包的符号链接;因是符号链接,执行 pip install -U fastapi 之类的升级后技能内容自动更新,无需重跑。

使用方式:无需全局安装,可用 uvx(Python)或 npx(JavaScript/TypeScript)直接运行。Python 项目:uvx library-skills;JavaScript/TypeScript 项目:npx library-skills;Claude Code 尚不支持标准 .agents 目录,可加参数:uvx library-skills --claude(除 .agents 外还安装到 .claude/skills)。CLI 选项仅有 --claude 与 --help。典型流程:先创建并激活含依赖的虚拟环境(如 uv venv、source .venv/bin/activate、uv add fastapi streamlit),再运行 uvx library-skills,按提示确认后生成 .agents/fastapi 等符号链接。JS/TS 先 npm install 或 pnpm install,再 npx library-skills。

适用场景:希望智能体使用库当前发布版所记录模式的 Python 与 JavaScript/TypeScript 项目;需要把技能纳入版本控制供团队共用时,可 git add .agents/ 后提交,但队友需有相同虚拟环境路径才能解析链接。

限制:库必须自带技能,并非所有库都支持,可在 agentskills.io 查看;uvx library-skills 找不到技能时需确认虚拟环境已激活或包已装在当前环境;符号链接默认是绝对路径,移动项目后会失效,需在新位置重跑;Claude Code 不加载 .agents/,需用 --claude;若怀疑技能未更新,可用 readlink .agents/fastapi 检查链接目标是否指向虚拟环境。库作者要发布技能,需在包目录内创建 skills/SKILL.md,发布到 PyPI 或 npm,并在 agentskills.io 注册。文档位于 https://library-skills.io,源码位于 https://github.com/tiangolo/library-skills,注册表位于 https://agentskills.io,包在 PyPI 与 npm 上名为 library-skills。