1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | langchain-fundamentals-langchain-ai-langchain-skills（SKILL.md 内部名称 langchain-fundamentals） |
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-fundamentals | — |
| 许可证 | MIT（声明于仓库 .claude-plugin/plugin.json 的 license 字段；仓库根目录未附独立 LICENSE 文件，故 GitHub API 的 license 字段显示为空） |
GitHub API + 仓库文件 |
| GitHub Stars/Forks | 所属合集仓库 langchain-ai/langchain-skills 整体 1,110★/86 forks（覆盖 22 个不同子技能，不代表本技能自身热度） |
GitHub API |
| 最新版本 | 0.1.0（plugin.json 声明） | GitHub |
| 安装方式 | npx skills add langchain-ai/langchain-skills --skill langchain-fundamentals --yes |
GitHub README |
2. 功能介绍与亮点
langchain-fundamentals 教编码 Agent 用 LangChain 当前官方推荐的方式搭建一个能跑起来的 Agent：create_agent() 一站式函数、@tool 装饰器定义工具、中间件挂钩人工审批与自定义流程。
主要亮点：
create_agent()权威用法：SKILL.md 明确写“必须用create_agent()，其余方式已过时”，覆盖 model / tools / system_prompt / checkpointer / middleware 五个核心参数，Python 与 TypeScript 双语言示例逐一对照- 工具定义规范：
@tool装饰器（Python）与tool()函数（TypeScript）的正确写法，附带“清晰 Args 说明 vs 模糊描述”的对比示例 - 中间件模式：
HumanInTheLoopMiddleware人工审批中断（配checkpointer+thread_id，可用Command(resume=...)恢复）、@wrap_tool_call/createMiddleware自定义工具调用钩子 - 结构化输出两条路径：
response_format参数（agent 级）与with_structured_output()（模型级），Pydantic BaseModel 与 Zod schema 双语言对照 - 5 类新手排障卡：工具描述缺失、忘配
checkpointer导致无记忆、忘设recursion_limit导致死循环、误访问result.content而非result["messages"]，每条都是“错误写法 → 正确写法”对照代码块
3. 适用场景
所属分类：元技能与 Agent 增强
适合刚开始用 LangChain 框架写第一个 Agent 的 Python 或 TypeScript 开发者，作为 create_agent()、工具定义与中间件基础的入门参考；也适合已有 Agent 项目、需要给它接入人工审批中断或结构化输出的中级开发者，直接照对应模式抄改即可。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 给出专属 Claude Code Plugin 安装方式（
/plugin marketplace add+/plugin install）与install.sh脚本。 - Codex：支持。README 用同一
npx skills通用安装器给出“Ask Codex: Install the … skill…“的具体示例，同一安装器同样适用于本技能。 - OpenClaw / Hermes Agent：❓ 未验证。抓取到的材料（README、SKILL.md）未提及这两个 Agent。
5. 推荐理由
create_agent() 是 LangChain 官方现在唯一推荐的 Agent 构建方式，此前的 AgentExecutor 等已被标记过时——框架迭代快，编码 Agent 很容易还在用旧模式写代码。本技能把当前正确写法、常用中间件模式与最容易踩的 5 个坑一次性打包成参考卡，双语言对照、开箱即用，不需要额外配置或付费依赖。LangChain 官方博客披露过，接入这套技能合集后 Claude Code 在 LangChain 相关任务上的通过率从约 29% 提升到 95%，说明这类参考指南对编码 Agent 确有实质帮助。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 LangChain 官方组织 langchain-ai 发布并维护（LangChain / LangGraph / Deep Agents / LangSmith 的所有权方）；所属合集仓库整体 1,110 stars，但该数字由 22 个子技能共享、不代表本技能自身热度；尚未检索到针对本技能自身的独立第三方报道 |
| 可用性 | 8 | 单文件 SKILL.md，无需安装任何额外依赖即可使用；双语言示例完整、含常见错误排障卡；仓库整体最近一次提交为 2026-08-07，但本技能所在文件最近一次实质改动为 2026-04-29，略超 3 个月窗口 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①技能本身不执行任何 shell 命令，纯提示词/代码示例文档，无脚本文件 ②不联网、不外发任何数据 ③不要求任何 API key 才能使用本技能自身，示例代码里的模型 API key 是使用 LangChain 本身的前提，非本技能索取的凭据 ④通读 SKILL.md 全文，未发现可疑指令、混淆内容或隐藏外发行为；2026-03-11 一次提交专门把示例里的 eval() 工具替换为安全的 add 工具（对应 issue #29），显示维护者对示例代码安全性有主动关注 ⑤LangChain 官方组织出品，langchain-ai 为 LangChain/LangGraph/Deep Agents/LangSmith 的官方开发方，无造假迹象 ⑥License 为 MIT，声明于仓库 .claude-plugin/plugin.json ⑦仓库最近一次提交为 2026-08-07，持续维护中
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
langgraph-fundamentals（同仓库姊妹技能） |
教 LangGraph 的 StateGraph/节点/边/状态归约等底层图 API |
面向需要自定义控制流（条件分支、循环）的场景；本技能是更高层的 create_agent 封装，适合固定工具集的单一目的 Agent，两者是官方选型决策树里的不同分支 |
building-pydantic-ai-agents（Pydantic AI 框架官方技能） |
教用 Pydantic AI 框架（而非 LangChain）构建 Agent | 同为“框架官方构建入门”定位但服务不同技术栈；Pydantic AI 该技能随框架主仓库发布、stars 未被拆分摊薄，本技能所属合集仓库的 stars 由 22 个子技能共享 |
langchain-python-quickstart / langchain-typescript-quickstart（同仓库） |
官方 Mintlify quickstart 的极薄包装，只问 provider/目录/API key | 不含中间件、结构化输出或排障内容，跑完示例即止；本技能覆盖面更完整，是quickstart 之后的进阶参考 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。LangChain 官方博客披露过，接入这套技能合集后 Claude Code 在内部基准任务上的通过率从约 29% 提升到 95%（2026 年 3 月披露，覆盖全部子技能的整体评测数据，非本技能单独测得）。
9. 其他补充
同仓库还有 langgraph-fundamentals、deep-agents-core 分别对应另两层框架（LangGraph 图编排、Deep Agents 高层封装）的核心构建技能，可配合 ecosystem-primer 的路由建议按需单独安装。仓库标注“early development”，README 明确提示 API 与技能内容可能变化。
10. 安装使用方式
- 单独安装本技能（推荐）：
npx skills add langchain-ai/langchain-skills --skill langchain-fundamentals --yes；全局安装加--global - 指定安装到 Claude Code：
npx skills add langchain-ai/langchain-skills --agent claude-code --skill langchain-fundamentals --yes --global - 作为 Claude Code 插件整包安装：
/plugin marketplace add langchain-ai/langchain-skills后/plugin install langchain-skills@langchain-skills（会装入该仓库全部 22 个子技能，而非仅此一个） - 安装后注意事项：技能本身不需要额外 API key 即可查阅；实际跑通示例代码需要在项目里配置模型提供商的 API key（如
ANTHROPIC_API_KEY/OPENAI_API_KEY），这是使用 LangChain 本身的前提，非本技能索取的凭据
11. 注意事项
- 仓库标注“early development”，README 明确提示 API 与技能内容可能变化
- 本技能所在文件最近一次实质改动约在 2026-04-29，虽仓库整体持续活跃（2026-08-07 有提交），但该文件内容本身近期改动较少
- 示例代码默认演示 Anthropic/OpenAI 模型，使用其他模型提供商时需自行替换
model参数