langchain-dependencies-langchain-ai-langchain-skills

1. 基本信息

项目	内容	数据来源
名称	langchain-dependencies-langchain-ai-langchain-skills（SKILL.md 内部名称 `langchain-dependencies`）	GitHub
作者/维护者	LangChain（`langchain-ai` 官方组织，LangChain / LangGraph / Deep Agents / LangSmith 的开发方）	GitHub API + plugin.json
来源链接	https://github.com/langchain-ai/langchain-skills/tree/main/config/skills/langchain-dependencies	—
许可证	MIT（声明于仓库 `.claude-plugin/plugin.json` 的 `license` 字段；仓库根目录未附独立 LICENSE 文件，故 GitHub API 的 license 字段显示为空）	GitHub API + 仓库文件
GitHub Stars/Forks	所属合集仓库 `langchain-ai/langchain-skills` 整体 1,110★/86 forks（覆盖 21 个不同子技能，不代表本技能自身热度）	GitHub API
最新版本	0.1.0（plugin.json 声明）	GitHub
安装方式	`npx skills add langchain-ai/langchain-skills --skill langchain-dependencies --yes`	GitHub README

2. 功能介绍与亮点

langchain-dependencies 是一份 Python + TypeScript 双语言的 LangChain 生态依赖版本参考手册，回答“该装哪个包、装哪个版本、什么时候会踩坑”。

主要亮点：

分类完整的包清单：必装包（langchain/langchain-core/langsmith）、编排层二选一（langgraph vs deepagents）、十余个模型提供商集成包、向量库与工具集成包，逐项标注最低版本
版本策略表：明确哪些包遵循严格 semver（langchain、langgraph 走 1.0 LTS）、哪个包不遵循 semver 因此必须锁定次版本（langchain-community），给出安全升级策略
6 类“常见错误”对照卡：误用已过时的 0.3 版本、langchain-community 未锁版本导致破坏性更新、社区工具包版本过旧、沿用已弃用的导入路径、TypeScript monorepo 漏装 peer dependency @langchain/core、Python/Node 版本不达标，每条都是“错误写法 → 正确写法”代码对照
环境变量清单：列全 LangSmith、8 家主流模型提供商、Tavily/Pinecone 等工具服务的环境变量命名规范

3. 适用场景

所属分类：工程效率与代码质量

适合正在搭建新 LangChain/LangGraph/Deep Agents 项目、需要一次性理清该装哪些包及版本约束的 Python 或 TypeScript 开发者；也适合排查依赖冲突、升级失败或导入路径报错的中级开发者，直接对照“常见错误”卡定位问题。

4. 跨 Agent 兼容性

Claude Code：原生支持。README 给出专属 Claude Code Plugin 安装方式（/plugin marketplace add + /plugin install）与 install.sh 脚本。
Codex：支持。README 用同一 npx skills 通用安装器给出面向 Codex 的安装示例，同一安装器同样适用于本技能。
OpenClaw / Hermes Agent：❓ 未验证。抓取到的材料（README、SKILL.md）未提及这两个 Agent。

5. 推荐理由

LangChain 生态迭代快，包之间版本耦合复杂（langchain-community 不遵循 semver、@langchain/core 是容易漏装的 peer dependency、旧导入路径持续被弃用），版本踩坑是搭项目时最容易卡住新手的地方之一。本技能把正确的包清单、版本策略与真实踩坑记录打包成一份可直接照抄的参考卡，无需任何配置或付费依赖，读完即可用；同仓库其他技能覆盖的是入门用法与中间件模式等使用层内容，与本技能这份环境配置参考互补而非重叠。

6. 评分

维度	分数	说明
受欢迎程度	7	由 LangChain 官方组织 `langchain-ai` 发布并维护（LangChain / LangGraph / Deep Agents / LangSmith 的所有权方）；所属合集仓库整体 1,110 stars，但该数字由 21 个子技能共享、不代表本技能自身热度；尚未检索到针对本技能自身的独立第三方报道
可用性	8	单文件 SKILL.md，纯参考表格与代码片段，无需安装任何额外依赖或申请密钥即可查阅使用；双语言内容完整、含 6 类真实踩坑对照；仓库整体最近一次提交为 2026-08-07，本技能所在文件最近一次实质改动为 2026-04-29
安全性	9	见下方检查清单

安全检查清单：①技能本身不执行任何 shell 命令，纯参考文档，无脚本文件 ②不联网、不外发任何数据 ③不要求任何 API key 才能使用本技能自身，文中列出的模型/服务环境变量是使用 LangChain 生态本身的前提，非本技能索取的凭据 ④通读 SKILL.md 全文，未发现可疑指令、混淆内容或隐藏外发行为 ⑤LangChain 官方组织出品，langchain-ai 为 LangChain/LangGraph/Deep Agents/LangSmith 的官方开发方，无造假迹象 ⑥License 为 MIT，声明于仓库 .claude-plugin/plugin.json ⑦仓库最近一次提交为 2026-08-07，持续维护中

7. 跟同类 Skills 相比的优势

对比对象	定位	与本技能的差异
`langchain-fundamentals`（同仓库姊妹技能）	教 `create_agent()`、工具定义与中间件的入门用法	面向“怎么写代码”；本技能面向“该装什么包、哪个版本”，两者互补而非重叠，一份讲用法一份讲环境
`ecosystem-primer`（同仓库姊妹技能）	框架选型（LangChain vs LangGraph vs Deep Agents）与环境搭建的起步向导	定位更早期、更概览化；本技能是选定框架后需要查阅的详细版本参考，颗粒度更细
各语言生态的通用依赖管理工具（如 `pip-tools`、`poetry`、`npm audit`）	通用包管理与锁定机制，不针对特定框架	不了解 LangChain 生态内部的版本耦合关系（如 `langchain-community` 不遵循 semver）；本技能是针对 LangChain 生态的专属知识，通用工具无法替代

8. 用户评价

该技能目前在第三方平台尚无经核实的具名用户评价。LangChain 官方博客披露过，接入这套技能合集后 Claude Code 在内部基准任务上的通过率从约 29% 提升到 95%（2026 年 3 月披露，覆盖全部子技能的整体评测数据，非本技能单独测得）。

9. 其他补充

同仓库还有 langchain-fundamentals、ecosystem-primer 等技能分别覆盖入门用法与框架选型，可配合本技能按需单独安装，组合成完整的项目启动参考。仓库标注“early development”，README 明确提示 API 与技能内容可能变化。

10. 安装使用方式

单独安装本技能（推荐）：npx skills add langchain-ai/langchain-skills --skill langchain-dependencies --yes；全局安装加 --global
指定安装到 Claude Code：npx skills add langchain-ai/langchain-skills --agent claude-code --skill langchain-dependencies --yes --global
作为 Claude Code 插件整包安装：/plugin marketplace add langchain-ai/langchain-skills 后 /plugin install langchain-skills@langchain-skills（会装入该仓库全部 21 个子技能，而非仅此一个）
安装后注意事项：技能本身不需要额外 API key 即可查阅；实际跑通项目仍需按文中环境变量清单配置所用模型提供商与工具服务的 API key，这是使用 LangChain 生态本身的前提，非本技能索取的凭据

11. 注意事项

仓库标注“early development”，README 明确提示 API 与技能内容可能变化
本技能所在文件最近一次实质改动约在 2026-04-29，版本号表格本身近期未见更新，使用时建议与官方文档核对最新版本号
内容以 LangChain 1.0 LTS 为基准，若项目仍在使用 0.3 系列旧版本，需先完成迁移再参考本技能的版本约束