# 编写 knowledge.json 配置

## 规则（Rules）

# 编写 knowledge.json 规范

## 模板

```json
{
  "name": "知识标识名（小写蛇形）",
  "title": "知识中文标题",
  "description": "一句话描述，50字以内，含用途和触发关键词",
  "group": "分组名（英文）",
  "tags": ["标签1", "标签2"]
}
```

> ℹ️ prompt_file 字段由系统默认生成，不需要在 knowledge.json 中填写。

## 字段说明

| 字段 | 必填 | 类型 | 说明 |
|:-----|:----:|:----:|:-----|
| name | 是 | string | 知识标识名，小写蛇形，全局唯一 |
| title | 是 | string | 知识中文标题，简明扼要 |
| description | 是 | string | 一句话描述，50字以内，含用途和触发关键词 |
| group | 是 | string | 知识分组，如 design / develop |
| tags | 是 | array[string] | 标签数组，关联技能/智能体 |

## 禁止行为
- ❌ 禁止写入 prompt_file 字段（系统默认生成）
- ❌ 禁止在 JSON 中写注释

## 格式要求
- 所有字段名和字符串值必须用双引号包裹
- 数组各项之间用逗号分隔
- 最后一项后面不能有多余逗号

## 方法（Methods）

# 编写 knowledge.json 方法

## 步骤

### 1. 确认信息
确认当前知识的以下信息：
- 知识标识名（name）：小写蛇形，如 color_system
- 知识中文标题（title）：如"色彩体系规范"
- 知识描述（description）：50字以内，含用途
- 知识分组（group）：所属领域分组
- 标签（tags）：关联技能/智能体的标签数组

### 2. 逐项填写
按模板逐项填入，注意字段对齐和格式正确。

### 3. 检查格式
- 字段名是否用双引号包裹
- 字符串值是否用双引号包裹
- 数组各项之间是否有逗号
- **不要写入 prompt_file 字段**（系统默认生成）
- JSON 是否可通过 JSON.parse 校验

## 技巧（Tips）

# 编写 knowledge.json 技巧

## 0. 容易踩的坑
- **误写 prompt_file 字段**：系统默认会生成，不需要手动填写

## 1. 标签（tags）设计
- tags 是 knowledge 与 skill/agent 关联的关键
- 一个 knowledge 可以被多个 skill 共享，tags 要覆盖所有关联方
- tags 命名：使用领域_主题的格式，如 `ui_design`、`frontend_layout`

## 2. 分组（group）建议
- design：设计相关的常识（色彩、排版、间距、图标）
- develop：开发相关的常识（命名、数据库、API）