# API接口设计

设计RESTful API接口规范。触发关键词：API设计、接口设计、RESTful。

## 执行步骤

### 步骤1：读取相关常识知识
使用 `read_knowledge knowledge_name='naming_conventions'`、`read_knowledge knowledge_name='project_structure'`

### 步骤2：读取工作提示词
使用 `read_work work_name='api_design'`、`read_work work_name='api_implementation'`

### 步骤3：分析需求
使用 `read_text` 读取需求文档。

### 步骤4：设计路由
定义API端点路径和HTTP方法。

### 步骤5：设计参数
明确请求参数类型和必填项。

### 步骤6：设计返回格式
定义统一响应格式。

### 步骤7：输出规范文档
使用 `write_text` 输出API设计文档。

## 输出成果
1. API接口设计规范文档

## 失败处理
- 若需求文档读取失败，基于口头描述设计
- 若规范与已有接口冲突，记录冲突点

## 禁止行为
- ❌ 禁止不分析需求直接设计接口
- ❌ 禁止设计不符合RESTful规范的API