企业级知识库产品深度拆解：腾讯乐享·知识库 最近在研究企业知识管理赛道，选了腾讯乐享·知识库作为第一个深度分析对象。打算写成系列博客，既是给自己梳理思路，也希望能给同样关注这个领域的同学一点参考。 前言：为什么研究这个产品？ 说实话，企业知识管理这个话题，在圈内讨论热度不算高。但如果你仔细观察，会发

Qwen系列 名字带有参数量的一般来说为开源模型 模型名称 输入模态 深度思考 函数调用

是什么 存放Skill的测试用例和评估规则，用于验证Skill的执行结果是否符合预期。 适合放什么 tests/ ├── test_cases.md # 测试场景描述 ├── fixtures/ # 测试输入数据 │ ├── input.csv │ └──

是什么 存放少样本（few-shot）输入输出示例，帮助Agent理解"输入长什么样、输出应该长什么样"。 为什么需要它 对于输出格式复杂、风格要求严格的Skill（如代码生成、文档撰写），光靠文字描述"输出格式"往往不够精确。直接给Agent看几个真实的输入输出样例，效果远好于长篇大论的规则描述：

是什么 存放Skill执行过程中需要的模板文件、样例文件、字体、图片等静态资源。与references/的区别在于：references/是给Agent阅读的文档，assets/是给Agent使用的素材。 适合放什么 资源类型 示例 用途 文档模板 report_template.docx Agen

是什么 存放按需加载的详细参考文档。当Agent在执行过程中需要查阅专业知识时，才去读取这些文件，而不是在激活Skill时一次性全部加载。 为什么需要它 SKILL.md正文有500行/5000tokens的软限制。如果把所有参考资料都塞进正文，会导致： 超出上下文预算，Agent无法完整读取 无关

好，现在我们来系统讲解Skill 的目录结构。前面我们讲的SKILL.md是Skill的"大脑"，而目录结构则是Skill的"身体"——它决定了脚本、参考文档、模板等资源如何组织，以及Agent在执行时如何按需加载它们。 一、整体结构总览 最小可用结构 一个 Skill 最少只需要一个文件： my-

Body Content（正文）是SKILL.md的核心灵魂，本质上是写给 Agent的SOP说明书。它位于frontmatter之后，负责告诉Agent激活后具体如何执行任务，并严格遵循≤500行（硬校验）、≤5000tokens（软校验）的篇幅限制，超出内容必须剥离至references/目录。

allowed-tools字段 allowed-tools字段是SKILL.md中唯一直接控制 Agent 运行时行为的字段：它本质上是在为Skill划定一个"工具沙箱"，决定Agent激活这个 Skill后能用什么、不能用什么。如果说description控制的是"什么时候激活"，那allowed

metadata 字段 metadata字段是SKILL.md中的**"万能收纳箱"**：当其他5个标准字段（name、description、license、compatibility、allowed-tools）装不下你的信息时，所有额外内容统统往这里塞。 metadata是什么 metadat