# mm API接口开发技能

在mm_os框架的 Plugin 中开发API接口。**API 接口不能独立存在，必须附属于某个 App 的 Plugin**（位于 `app/{模块名}/plugin/{插件名}/` 目录下）。包括api.json路由配置、index.js业务处理器编写和API文档生成。触发关键词：mm API、接口开发、创建API、路由配置、业务脚本。

## 执行步骤

### 步骤0：获取运行路径
使用 `get_run_path` 工具获取当前程序运行根目录，确认是否为 mm_os 项目。后续所有文件操作基于此路径。

### 步骤1：读取相关常识知识
使用 `read_knowledge` 读取以下常识知识，了解领域规范和标准：
- 使用 `read_knowledge knowledge_name='mm_os_framework'`
- 使用 `read_knowledge knowledge_name='naming_conventions'`
- 使用 `read_knowledge knowledge_name='project_structure'`
- 使用 `read_knowledge knowledge_name='logging_standards'`

### 步骤2：读取工作提示词
使用 `read_work` 读取以下工作提示词，按规范流程执行：
- 使用 `read_work work_name='script_mm_api'`
- 使用 `read_work work_name='validate_mm_param'`
- 使用 `read_work work_name='handle_mm_error'`

### 步骤3：分析接口需求
使用 `read_text` 读取需求文档，明确接口的入参、出参和业务逻辑。确认目标 Plugin 和 App。

### 步骤4：配置路由（api.json）
使用 `write_text` 编写 api.json 路由配置文件，定义接口路径、方法和权限。

### 步骤5：编写业务处理器（index.js）
使用 `write_text` 编写 index.js 业务脚本，实现核心业务逻辑。

### 步骤6：配置参数校验（param.json）
使用 `write_text` 编写 param.json 参数校验配置。

### 步骤7：编写接口文档
使用 `write_text` 生成API接口文档。

## 输出成果
1. api.json 路由配置
2. index.js 业务处理器
3. param.json 参数校验
4. API接口文档

## 失败处理
- 若路由冲突，调整路径并记录变更
- 若业务逻辑错误，回滚到上一版本并重新分析

## 禁止行为
- ❌ 禁止不配置参数校验就上线API
- ❌ 禁止忽略接口文档编写
- ❌ 禁止跳过 `get_run_path` 直接操作文件
- ❌ 禁止在 Plugin 之外创建独立 API 接口