# 创建工具标准

## 规则（Rules）

# 工具创建规范 - 规则文档

## 任务目标
按标准化流程创建工具，确保tool.json配置正确，避免配置错误。

## 输入条件
- 工具需求（功能、输入、输出）
- 工具命名规范
- 目标智能体信息

## 必须遵守的规则

### 规则1：标准化配置流程
- 从零编写tool.json，不得直接复制其他工具的配置
- 每个字段必须理解其含义后再填写
- 配置完成后逐项自检

### 规则2：tool.json必填字段
- **name**：小写蛇形，唯一标识
- **title**：中文名称
- **description**：功能描述，50字以内
- **params**：参数定义，每个参数包含type、required、desc
- **returns**：返回值定义，包含type和desc
- **group**：分组，如default、develop、service

### 规则3：自检要求
创建完成后必须逐项核对：
- 工具名称是否正确
- 所有参数是否完整定义
- 返回值格式是否清晰
- 主入口路径是否正确

## 输出要求
- 创建完成的工具（tool.json + index.js）

## 方法（Methods）

# 工具创建规范 - 方法文档

## 操作流程

### 步骤1：需求确认
- 明确工具名称（name）
- 确定工具标题（title）
- 编写功能描述（description）
- 定义参数（params）和返回值（returns）
- 确定分组（group）

### 步骤2：编写tool.json
- 从零开始编写配置
- 逐字段填写，确保理解每个字段含义
- 参数定义完整（类型、必填、描述）

### 步骤3：创建工具
- 调用工具创建功能
- 传入完整参数

### 步骤4：创建后自检
- 读取刚创建的tool.json
- 逐项核对所有字段
- 确认配置正确性

## 技巧（Tips）

# 工具创建规范 - 技巧文档

## 最佳实践

### 配置编写技巧
- 先列大纲再逐项填写
- 参数名使用小写蛇形
- 描述简洁明了，避免歧义

### 自检清单
- name是否符合命名规范
- title是否清晰表达功能
- description是否在50字以内
- params是否覆盖所有输入
- returns是否定义清晰

### 常见错误
- **忘记必填参数**：列出所有参数逐一检查
- **类型定义错误**：确认使用正确的类型名称
- **路径配置错误**：确认main指向正确的文件路径
- **分组不当**：选择最匹配的功能分组

### 经验要点
- 参数顺序按重要程度排列
- 可选参数设置合理的默认值
- 返回值包含足够的信息