# 编写 knowledge.md

## 规则（Rules）

# 编写 knowledge.md 规范

## 模板结构

```markdown
# 知识标题

## 章节1
- 条目1
- 条目2

## 章节2
| 列1 | 列2 |
|:----|:----|
| 值1 | 值2 |
```

## 内容规范

1. **纯声明性**：仅包含事实、规格、标准、规范，无步骤流程
2. **表格优先**：能用表格表达的数据优先用表格
3. **标签关联**：tags 必须与对应技能/智能体的标签匹配
4. **分层组织**：用 ## 和 ### 分层，每层聚焦一个主题
5. **无工具调用**：不出现工具名、API、代码示例

## 禁止行为
- ❌ 禁止包含 Step 1/2/3 步骤编号
- ❌ 禁止包含工具调用和文件操作
- ❌ 禁止包含代码示例和 API 调用
- ❌ 禁止使用"根据需要处理"等模糊表述

## 方法（Methods）

# 编写 knowledge.md 方法

## 前置条件
- [ ] 已确定知识所属领域（分组）
- [ ] 已了解该领域的常用标签

## 步骤

### 1. 确定知识内容和范围
明确要描述的知识领域，收集相关规格、标准、规范数据。

### 2. 编写正文
- 使用表格组织结构化数据
- 使用列表组织规则和标准
- 每个一级标题（##）聚焦一个知识领域

### 3. 检查清单
- [ ] 内容是否纯声明性（无步骤流程）
- [ ] tags 是否能匹配目标技能/智能体
- [ ] 表格数据是否准确完整
- [ ] 是否有模糊表述

## 技巧（Tips）

# 编写 knowledge.md 技巧

## 1. tags 的选择策略
- 从技能的 tags 反向匹配：知识 tags 覆盖技能 tags
- 粒度适中：太细（`button_size_12px`）太粗（`design`）都不好
- 参考举例：`["ui_design", "icon_design", "frontend_layout"]`

## 2. 数据的准确性
常识知识会被多个团队复用，数据必须准确。不确定时标注待确认。

## 3. 表格设计
- 首列放分类/级别，第二列放值
- 用 `:--` 左对齐、`:--:` 居中、`--:` 右对齐控制格式
- 避免表格太宽（超过 6 列拆分为多个表）