# knowledge 常识知识

本质是各智能体/技能之间共享的常识性知识或共识规范，起到"公共提示词"的作用。
当加载相应技能时，关联的常识知识会被一并注入到智能体的上下文中。

## 与技能（skill）的关系

技能（skill）定义"怎么做"——执行步骤、工具调用、注意事项。
常识知识（knowledge）定义"知道什么"——共享的领域知识、尺寸规范、命名约定等通用规则。

例如：UI设计、图标设计和前端排版都共享"图标尺寸"这份常识，UI设计时使用迷你/小/常规/大/较大/特大尺寸体系，图标设计师按该体系设计图标，前端也按此做粗略的页面板块划分。

## 结构规范

一个规范的知识项是一个命名文件夹，包含以下文件：

```text
knowledge-name/
├── knowledge.md          # 【必需】核心知识文件
└── knowledge.json        # 【必需】配置文件
```

### knowledge.json 配置规范

```json
{
  "name": "knowledge-name",
  "title": "知识标题",
  "description": "知识描述，说明适用场景和触发关键词",
  "version": "1.0.0",
  "prompt_file": "./knowledge.md",
  "group": "default",
  "tags": ["ui_design", "icon_design", "frontend"]
}
```

### knowledge.md 规范

- 包含 YAML Frontmatter 元数据
- 内容组织清晰，按知识点分类
- 使用统一的格式和规范描述
- 便于多技能/多智能体复用

## 加载机制

常识知识通过标签（tags）与技能/智能体关联。在加载技能时，系统会查询匹配标签的常识知识，将其内容合并到技能上下文中。