1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | ecosystem-primer-langchain-ai-langchain-skills（SKILL.md 内部名称 ecosystem-primer） |
GitHub |
| 作者/维护者 | LangChain（langchain-ai 官方组织，LangChain / LangGraph / Deep Agents / LangSmith 的开发方） |
GitHub API + plugin.json |
| 来源链接 | https://github.com/langchain-ai/langchain-skills/tree/main/config/skills/ecosystem-primer | — |
| 许可证 | 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 ecosystem-primer --yes |
GitHub README |
2. 功能介绍与亮点
ecosystem-primer 是这套技能合集里唯一标注“INVOKE FIRST”（必须最先调用）的技能，在编码 Agent 动手写任何 Agent 代码之前，先帮它做三件事：选框架层、配环境变量、找到下一个该加载的技能。
主要亮点：
- 四条优先级决策规则：需要长会话规划/文件管理/持久记忆/子 Agent 委派 → Deep Agents；需要自定义控制流（确定性循环、条件分支）→ LangGraph；固定工具集的单一目的 Agent → LangChain
create_agent；纯模型调用或检索管道 → LangChain 直接调用，一步到位选定该学哪一层 - 三层能力画像：LangChain（框架层）、LangGraph（运行时层）、Deep Agents（封装层，内置规划/文件管理/子 Agent 派生/记忆）、LangSmith（横切可观测性层）各自的“最适合”与“不适合”场景逐条列出
- 混合组合模式：说明 Deep Agents 编排器可以把一个 LangGraph 图注册为具名子 Agent 直接调用，两层可以在同一项目里叠加而不必二选一
- 文档索引与环境变量指引：给出当前有效的 LangSmith 环境变量名（旧名已失效，SKILL.md 特别标注“OLDER NAMES NO LONGER WORK”），并说明 docs.langchain.com 的文档树结构与可选 MCP 文档服务器的调用方式
- 显式路由到下一个技能：按选定的层给出该继续加载哪个姊妹技能（如
langgraph-human-in-the-loop、deep-agents-memory等），形成完整的“决策→执行”闭环
3. 适用场景
所属分类：元技能与 Agent 增强
适合刚开始规划新 Agent 项目、还没确定该用 LangChain、LangGraph 还是 Deep Agents 的开发者——比如不确定一个简单工具调用 Agent 该用 create_agent 还是需要上 LangGraph 自定义控制流，或者不确定需要长会话规划与子 Agent 委派的场景该不该直接上 Deep Agents。也适合已经在这套生态里工作、但需要快速确认某个具体功能（如跨会话记忆、人工审批中断）该去哪个姊妹技能查阅的中级开发者。
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. 推荐理由
这套合集里已有多个姊妹技能被推荐过，但它们各自解决的是“某一层具体怎么写”的问题——而新手最先卡住的往往是“我该学哪一层”。ecosystem-primer 正是补上这个决策缺口：不需要额外安装、不依赖任何付费服务，用一张决策表就能让开发者在动笔前少走弯路，还能直接指向该继续读哪个姊妹技能。作为整个技能包“Getting Started”分区里的入口技能，几乎是使用这个合集里任何其他技能的前提步骤。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 LangChain 官方组织 langchain-ai 发布并维护（LangChain / LangGraph / Deep Agents / LangSmith 的所有权方）；所属合集仓库整体 1,110 stars，但该数字由 21 个子技能共享、不代表本技能自身热度；尚未检索到针对本技能自身的独立第三方报道 |
| 可用性 | 9 | 纯决策指南类技能，无需安装任何额外依赖或付费服务即可使用；文档结构完整（决策表 + 各层能力画像 + 组合模式 + 环境变量 + 文档索引）；仓库整体最近一次提交为 2026-08-07，本技能所在文件最近改动为 2026-07-22，均在近 3 个月内 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①技能本身不执行任何 shell 命令，纯提示词/文档内容 ②仅建议性提及可选的联网行为——按需拉取 docs.langchain.com 公开文档页或调用可选的 MCP 文档服务器，均为透明的公开文档访问，非用户数据外发 ③不要求任何 API key 才能使用本技能自身；文中列出的 LANGSMITH_API_KEY 等是给下游其他技能用的环境变量指引，非本技能索取的凭据 ④通读 SKILL.md 全文，未发现可疑指令、混淆内容或隐藏外发行为 ⑤LangChain 官方组织出品，langchain-ai 为 LangChain/LangGraph/Deep Agents/LangSmith 的官方开发方，无造假迹象 ⑥License 为 MIT，声明于仓库 .claude-plugin/plugin.json ⑦仓库最近一次提交为 2026-08-07，持续维护中
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
langgraph-fundamentals / deep-agents-core / langchain-fundamentals（同仓库姊妹技能） |
分别教怎么在某一层动手写代码 | 三者解决的是“选定某层之后怎么写”，本技能解决的是前置的“该选哪层”，是同一决策链路里更靠前的环节 |
| 通用 AI 框架对比类文章/博客 | 提供一次性的框架对比知识 | 停留在信息层面，不会随框架 API 变化更新，也不会指向具体下一步该做什么；本技能与仓库其余 20 个技能联动，选完层直接给出该继续加载的技能名 |
langsmith-skills 独立仓库的对应入口技能 |
面向 LangSmith 的 trace / dataset 工作流入口 | 定位互补而非竞争——README 明确注明 LangSmith 专属工作流应改用另一个独立仓库 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。LangChain 官方博客披露过接入这套技能合集后 Claude Code 在内部基准任务上的通过率从约 29% 提升到 95%（2026 年 3 月披露，21 个技能整体评测数据，非本技能单独测得）。
9. 其他补充
同仓库还包含 langchain-fundamentals / langgraph-fundamentals / deep-agents-core 三层各自的核心编码技能，以及 langgraph-persistence、langgraph-human-in-the-loop、deep-agents-memory、langchain-rag、langgraph-cli 等围绕具体功能的姊妹技能，可按 ecosystem-primer 的路由建议单独安装，不必整包引入。仓库标注“early development”，API 与技能内容可能变化。
10. 安装使用方式
- 单独安装本技能（推荐）：
npx skills add langchain-ai/langchain-skills --skill ecosystem-primer --yes；全局安装加--global - 指定安装到 Claude Code：
npx skills add langchain-ai/langchain-skills --agent claude-code --skill ecosystem-primer --yes --global - 作为 Claude Code 插件整包安装：
/plugin marketplace add langchain-ai/langchain-skills后/plugin install langchain-skills@langchain-skills（会装入该仓库全部 21 个子技能，而非仅此一个） - 安装后注意事项：本技能不需要额外可执行文件或 API key 即可直接使用；使用其推荐的下游技能（如
langgraph-cli的deploy）时才需按各自要求配置对应凭据
11. 注意事项
- 仓库标注“early development”，README 明确提示 API 与技能内容可能变化
- 技能内提到的部分下游技能（如
langsmith-online-eval-engineering）依赖付费/托管服务，本技能自身不涉及此类依赖 - 仓库未附独立 LICENSE 文件，MIT 许可仅声明于
.claude-plugin/plugin.json，比对时需留意这一细节