mm_ai 1.0.0

package/common/skill/tool/code_implementation/skill.md

@@ -0,0 +1,132 @@
+# 代码实现技能
+
+## 触发条件
+- 需要编写工具代码时
+- 需要为工具编写测试用例时
+- 需要验证工具功能正确性时
+- 需要调试和修复工具代码时
+
+## 输入假设
+- 已明确工具的功能需求和接口规范
+- 已确认使用的编程语言（JavaScript 或 Python）
+- 已确认测试框架（Jest/Mocha 或 pytest）
+
+## 执行步骤
+
+### 步骤1：读取做事提示词
+使用 `read_work work_name='implement_code'` 读取代码实现的做事提示词规范，了解代码编写和测试的标准流程。
+
+### 步骤2：确定技术方案
+根据工具需求确定：
+- **编程语言**：JavaScript（Node.js）或 Python
+- **核心逻辑**：工具的主要功能算法和流程
+- **依赖库**：需要用到的第三方库或内置模块
+- **测试框架**：JS 用 Jest/Mocha，Python 用 pytest
+
+### 步骤3：编写工具代码
+使用 `write_text` 编写工具主文件（如 `index.js` 或 `tool.py`），遵循以下规范：
+
+**JavaScript 代码规范：**
+```javascript
+/**
+ * {工具标题}
+ * @description {工具功能描述}
+ * @param {Object} params - 输入参数对象
+ * @param {string} params.xxx - 参数说明
+ * @returns {Promise<Object>} 统一返回格式
+ */
+async function main(params) {
+  try {
+    // 参数校验
+    if (!params.xxx) {
+      return { code: 400, msg: '缺少必填参数: xxx' };
+    }
+    
+    // 核心业务逻辑
+    const result = await doSomething(params);
+    
+    // 成功返回
+    return { code: 0, msg: '成功', data: result };
+  } catch (error) {
+    // 异常处理
+    return { code: 500, msg: `执行失败: ${error.message}` };
+  }
+}
+
+module.exports = { main };
+```
+
+**Python 代码规范：**
+```python
+async def main(params: dict) -> dict:
+    """
+    {工具标题}
+    @description {工具功能描述}
+    @param params: 输入参数对象
+    @returns: 统一返回格式
+    """
+    try:
+        # 参数校验
+        if not params.get('xxx'):
+            return {'code': 400, 'msg': '缺少必填参数: xxx'}
+        
+        # 核心业务逻辑
+        result = await do_something(params)
+        
+        # 成功返回
+        return {'code': 0, 'msg': '成功', 'data': result}
+    except Exception as e:
+        # 异常处理
+        return {'code': 500, 'msg': f'执行失败: {str(e)}'}
+```
+
+### 步骤4：编写测试用例
+使用 `write_text` 编写测试文件（如 `index.test.js` 或 `test_tool.py`），覆盖正常、边界、异常三种场景。
+
+### 步骤5：执行测试验证
+使用 `exec_code` 或 `run_script` 运行测试文件，验证测试结果。
+
+### 步骤6：调试修复
+如果测试失败：
+1. 分析错误日志，定位问题代码
+2. 使用 `edit_file` 修改代码
+3. 重新执行测试验证
+4. 重复直到所有测试通过
+
+### 步骤7：代码审查
+最终审查代码质量：
+- ✅ 代码逻辑是否正确完整
+- ✅ 是否有完善的错误处理
+- ✅ 是否有充分的注释说明
+- ✅ 命名是否符合规范
+- ✅ 是否有不必要的依赖
+- ✅ 测试覆盖率是否覆盖正常/边界/异常场景
+
+### 步骤8：通知完成
+使用 `notify_user` 告知代码实现完成，并附上测试结果摘要。
+
+## 中间检查点
+**步骤3完成后检查**：代码是否符合语言规范？入口函数是否正确？返回格式是否统一？
+**步骤4完成后检查**：测试用例是否覆盖正常、边界和异常三种场景？
+**步骤5完成后检查**：测试是否全部通过？是否有失败的测试用例？
+**步骤6完成后检查**：失败的用例是否已修复并重新验证通过？
+
+## 输出成果
+1. `./ai/tool/{工具名称}/index.js` 或 `./ai/tool/{工具名称}/tool.py` — 工具代码文件
+2. `./ai/tool/{工具名称}/index.test.js` 或 `./ai/tool/{工具名称}/test_tool.py` — 测试用例文件
+3. 测试执行结果报告
+
+## 失败回退
+- **语法错误**：使用 `get_diagnostics` 检查代码错误，修复后重新执行
+- **测试失败**：分析失败原因，定位问题代码，修复后重新测试
+- **依赖缺失**：使用 `npm install` 或 `pip install` 安装缺失依赖
+- **逻辑错误**：检查业务逻辑是否符合需求文档，必要时调整算法
+- **多次重试仍失败**：联系 tool_tester 协助排查，或向 master 报告
+
+## 禁止行为
+- ❌ 禁止不读做事提示词就编写代码
+- ❌ 禁止不编写测试用例就提交代码
+- ❌ 禁止忽略测试失败直接交付
+- ❌ 禁止硬编码敏感信息
+- ❌ 禁止使用不安全的 eval() 或 exec() 执行用户输入
+- ❌ 禁止提交有语法错误的代码

package/common/skill/tool/tool_build/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "tool_build",
+  "title": "工具构建",
+  "description": "工具匠人掌握的工具构建技能，能设计实现工具代码，确保功能正确结构清晰。触发关键词：构建工具、工具构建、实现工具",
+  "version": "1.1.0",
+  "prompt_file": "./skill.md",
+  "tools": ["read_work", "read_text", "write_text", "edit_file", "make_dir", "create_tool", "call_agent", "exec_code", "run_script", "notify_user"]
+}

package/common/skill/tool/tool_build/skill.md

@@ -0,0 +1,85 @@
+# 工具构建技能
+
+## 触发条件
+- 需要构建新工具时
+- 需要设计工具的功能逻辑时
+- 需要定义工具的输入参数和输出格式时
+- 需要确保工具结构清晰、可维护时
+
+## 输入假设
+- 已明确工具需求（功能、输入、输出）
+- 已有工具命名规范参考
+- 目标智能体已明确
+
+## 执行步骤
+
+### 步骤1：读取做事提示词
+使用 `read_work work_name='build_tool'` 读取工具构建的做事提示词规范，了解工具构建的完整流程和标准。
+
+### 步骤2：分析工具需求
+明确工具的核心功能、输入参数、输出结果和使用场景：
+- **工具名称（name）**：小写蛇形，如 `user_query`、`data_export`
+- **工具标题（title）**：中文名称，如 "用户查询工具"、"数据导出工具"
+- **功能描述（description）**：清晰描述工具能做什么，50字以内
+- **输入参数（params）**：定义每个参数的类型、是否必填、默认值、描述
+- **输出结果（returns）**：定义返回数据的结构和格式
+- **分类（group）**：工具所属分类
+- **使用场景**：什么情况下会被调用
+
+### 步骤3：创建工具目录
+使用 `make_dir` 创建工具目录，路径规范为 `./ai/tool/{分类}/{工具名}/`。
+
+> **关键路径规范**：当前是架构阶段，工具的所有文件必须放在**运行项目的目录**下。`./ai/tool/{分类}/{工具名}/` 是工具文件的唯一存放目录。**禁止**将文件放在系统模块目录 `./common/tool/` 中，否则工具文件分散在两处，无法被正确加载使用。
+
+### 步骤4：编写工具代码
+使用 `write_text` 编写 `index.js` 工具脚本，保存到 `./ai/tool/{分类}/{工具名}/index.js`，包含以下核心结构：
+- 使用 `async function main(params)` 作为入口函数
+- 严格进行参数校验，返回统一格式的错误信息
+- 成功返回 `{ code: 0, msg: '成功', data: {...} }`
+- 失败返回 `{ code: 错误码, msg: '错误描述' }`
+- 添加完整的 JSDoc 注释
+- 避免硬编码敏感信息
+
+### 步骤5：编写工具配置文件
+使用 `write_text` 编写 `tool.json`，保存到 `./ai/tool/{分类}/{工具名}/tool.json`。
+配置 name、title、description、params、returns、group、main、func_name 等字段。
+
+> **注意**：tool.json 和 index.js 必须放在**同一个目录**下（即 `./ai/tool/{分类}/{工具名}/`），确保工具文件完整不分散。
+
+### 步骤6：注册工具
+调用 `create_tool` 创建工具实体，传入完整参数（name、title、description、params、returns、group）。
+
+### 步骤7：自检确认
+使用 `read_text` 读取刚创建的 `tool.json`，逐项核对：
+- ✅ 工具名称是否正确
+- ✅ 所有参数是否完整定义
+- ✅ 返回值格式是否清晰
+- ✅ 主入口路径是否正确
+
+### 步骤8：通知完成
+使用 `notify_user` 告知工具构建完成。
+
+## 中间检查点
+**步骤4完成后检查**：代码是否符合编码规范？入口函数是否为 `async main(params)`？返回格式是否统一？
+**步骤5完成后检查**：tool.json 配置是否完整？参数类型定义是否准确？
+**步骤7完成后检查**：自检是否通过？所有字段是否正确？
+
+## 输出成果
+1. `./ai/tool/{分类}/{工具名}/index.js` — 工具脚本文件
+2. `./ai/tool/{分类}/{工具名}/tool.json` — 工具配置文件
+3. 已注册到系统的工具实体
+
+## 失败回退
+- **参数校验失败**：返回 `{ code: 400, msg: '具体错误信息' }`
+- **代码执行异常**：使用 try-catch 捕获，返回 `{ code: 500, msg: error.message }`
+- **注册失败**：检查 tool.json 配置是否正确，重新调用 create_tool
+- **多次重试仍失败**：联系 tool_tester 或 master 协助排查
+
+## 禁止行为
+- ❌ 禁止不读做事提示词就构建工具
+- ❌ 禁止硬编码敏感信息（密钥、密码等）
+- ❌ 禁止编写未经验证的逻辑
+- ❌ 禁止直接复制其他工具的代码作为模板
+- ❌ 禁止跳过参数校验步骤
+- ❌ 禁止将 index.js 放在 `./common/tool/` 目录下（应与 tool.json 同目录）
+- ❌ 禁止将工具文件分散到不同目录

package/common/skill/tool/tool_chain_testing/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "tool_chain_testing",
+  // 技能标题(显示用的中文名称)
+  "title": "工具调用链测试",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "在工具存在依赖关系或调用链时，测试工具之间的联动和依赖关系，验证数据在调用链中传递的完整性和准确性，识别级联风险",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}

package/common/skill/tool/tool_chain_testing/skill.md

@@ -0,0 +1,21 @@
+# 工具调用链测试
+
+## 基本信息
+- **名称**: tool_chain_testing
+- **描述**: 测试工具之间的联动和依赖关系，验证工具A的输出是否能正确作为工具B的输入，数据传递的完整性和准确性
+- **依赖工具**: get_tool_list, get_tool_detail, read_work
+
+## 执行步骤
+1. **读做事提示词**：使用 `read_work` 工具，参数 `work_name='test_tool_chain'`
+2. **分析工具依赖关系**：调用 `get_tool_list` 查看所有可用工具，调用 `get_tool_detail` 逐个获取工具的配置信息，分析工具之间的依赖关系
+3. **设计调用链测试方案**：根据依赖关系设计调用链路径，为每个路径设计测试用例
+4. **执行调用链测试**：按调用链顺序依次调用工具，验证工具A的输出是否能正确作为工具B的输入
+5. **验证数据传递一致性**：比对工具A输出格式与工具B输入参数的匹配度
+6. **分析级联风险**：测试调用链中某个环节失败时的影响范围
+
+## 输出成果
+1. 工具调用链测试报告
+
+## 禁止行为
+- ❌ 禁止不先读做事提示词就测试
+- ❌ 不得修改或删除被测试工具的任何配置

package/common/skill/tool/tool_create_standard/skill.json

@@ -0,0 +1,22 @@
+{
+    "name": "tool_create_standard",
+    "title": "工具创建规范流程",
+    "description": "确保工具匠人按标准化流程创建工具，避免tool.json配置错误。触发关键词：创建工具、新建工具、工具标准化",
+    "version": "1.0.0",
+    "prompt_file": "./skill.md",
+    "tools": [
+        "create_tool",
+        "set_tool",
+        "read_text",
+        "write_text",
+        "call_agent",
+        "read_skill"
+    ],
+    "main": "",
+    "func_name": "main",
+    "scope": "sys",
+    "sort": 10,
+    "state": 1,
+    "show": 0,
+    "end": false
+}

package/common/skill/tool/tool_create_standard/skill.md

@@ -0,0 +1,44 @@
+# tool_create_standard（工具创建规范流程）
+
+## 执行步骤
+
+### 步骤1：读做事提示词
+使用 `read_work` 工具，参数 `work_name='create_tool_standard'`。
+
+### 步骤2：需求确认
+明确工具名称（name）、标题（title）、功能描述（description）、参数（params）、返回值（returns）、分类（group）。
+
+### 步骤3：创建工具目录
+使用 `make_dir` 创建工具目录，路径规范为 `./ai/tool/{分类}/{工具名}/`。
+
+> **路径规范**：当前是架构阶段，工具的所有文件（tool.json + index.js + 其他资源）必须放在**运行项目的目录**下，即 `./ai/tool/{分类}/{工具名}/`。**禁止**将文件放在 `./common/tool/` 系统模块目录下。
+
+### 步骤4：编写 tool.json
+使用 `write_text` 从零编写 tool.json 配置文件，保存到 `./ai/tool/{分类}/{工具名}/tool.json`。
+配置字段包括：name、title、description、params、returns、group、main、func_name 等。
+
+### 步骤5：编写 index.js
+使用 `write_text` 编写工具脚本，保存到 `./ai/tool/{分类}/{工具名}/index.js`。
+
+> **注意**：tool.json 和 index.js 必须放在**同一个目录** `./ai/tool/{分类}/{工具名}/` 下，不可分散存放。
+
+### 步骤6：创建工具
+调用 `create_tool` 创建工具实体，传入完整参数。
+
+### 步骤7：创建后自检
+调用 `read_text` 读取刚创建的 tool.json，逐项核对配置正确性。
+
+## 输出成果
+1. `./ai/tool/{分类}/{工具名}/tool.json` — 工具配置文件
+2. `./ai/tool/{分类}/{工具名}/index.js` — 工具脚本文件
+3. 已注册到系统的工具实体
+
+## 失败回退
+- **目录创建失败**：检查 `./ai/tool/` 目录是否存在，手动创建
+- **注册失败**：检查 tool.json 配置是否正确，重新调用 create_tool
+
+## 禁止行为
+- ❌ 禁止不先读做事提示词就创建工具
+- ❌ 禁止直接复制其他已有工具的 tool.json 作为模板
+- ❌ 禁止将工具文件放在 `./common/tool/` 目录下
+- ❌ 禁止将 tool.json 和 index.js 放在不同目录

package/common/skill/tool/tool_development/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "tool_development",
+  "title": "工具开发技能",
+  "description": "智能体工具研发的专业技能，涵盖工具需求分析、功能设计、代码实现、测试验证、部署赋予与维护优化全流程",
+  "version": "1.1.0",
+  "prompt_file": "./skill.md",
+  "tools": ["read_work", "read_text", "write_text", "edit_file", "make_dir", "create_tool", "provide_tools", "call_agent", "notify_user"]
+}

package/common/skill/tool/tool_development/skill.md

@@ -0,0 +1,46 @@
+# 工具开发技能
+
+## 执行步骤
+
+### 步骤1：读做事提示词
+使用 `read_work` 工具，参数 `work_name='develop_tool'`。
+
+### 步骤2：分析工具需求
+明确工具的功能、输入参数和输出结果，确定工具的分类（group）。
+
+### 步骤3：创建工具目录
+使用 `make_dir` 创建工具目录，路径规范为 `./ai/tool/{分类}/{工具名}/`。
+
+> **关键路径规范**：当前是架构阶段，工具的所有文件必须放在**运行项目的目录**下，即 `./ai/tool/{分类}/{工具名}/`。**禁止**将文件放在系统模块目录 `./common/tool/` 中，否则工具文件分散在两处，无法被正确加载使用。
+
+### 步骤4：编写 index.js
+使用 `write_text` 编写工具脚本，包含 `async main(params)` 入口函数，保存到 `./ai/tool/{分类}/{工具名}/index.js`。
+
+### 步骤5：编写 tool.json
+使用 `write_text` 编写工具配置文件，保存到 `./ai/tool/{分类}/{工具名}/tool.json`。
+
+> **注意**：tool.json 和 index.js 必须放在**同一个目录**下，即 `./ai/tool/{分类}/{工具名}/`，确保工具文件完整不分散。
+
+### 步骤6：注册工具
+调用 `create_tool` 注册到系统。
+
+### 步骤7：测试验证
+联系 tool_tester 进行功能测试。
+
+### 步骤8：赋予工具
+调用 `provide_tools` 为智能体赋予工具。
+
+## 输出成果
+1. `./ai/tool/{分类}/{工具名}/index.js` — 工具脚本文件
+2. `./ai/tool/{分类}/{工具名}/tool.json` — 工具配置文件
+
+## 失败回退
+- **目录创建失败**：检查 `./ai/tool/` 目录是否存在
+- **注册失败**：检查 tool.json 配置是否正确
+- **测试不通过**：根据测试反馈修复代码
+
+## 禁止行为
+- ❌ 禁止不先读做事提示词就开发
+- ❌ 禁止硬编码敏感信息
+- ❌ 禁止将 index.js 放在 `./common/tool/` 目录下（应与 tool.json 同目录）
+- ❌ 禁止将工具文件分散到不同目录

package/common/skill/tool/tool_development/tool_dev_code_examples.md

@@ -0,0 +1,188 @@
+# 工具开发代码示例（参考文件）
+
+> 本文件为 `tool_development` 技能的参考文件，提供工具开发的完整代码示例。
+
+## 一、工具脚本完整示例（index.js）
+
+### 基本结构
+
+```javascript
+module.exports = {
+  // 辅助方法（可选）
+  helperFunction: function (param1, param2) {
+    // 参数校验
+    if (!param1) {
+      throw new TypeError('param1 不能为空');
+    }
+    // 业务逻辑
+    return someResult;
+  },
+  
+  /**
+   * 主要逻辑
+   * @param {object} params 参数
+   * @param {string} params.param1 参数1描述
+   * @param {number} params.param2 参数2描述
+   * @returns {Object} 执行结果
+   */
+  async main(params) {
+    let ret;
+    try {
+      // 调用辅助方法（使用 this 调用同对象下的方法）
+      let result = await this.helperFunction(params.param1, params.param2);
+      
+      ret = {
+        code: 0,
+        msg: '操作成功',
+        // 返回数据字段按实际命名
+        data_field: result
+      };
+    } catch (error) {
+      ret = {
+        code: 10000,
+        msg: error.message
+      };
+    }
+    return ret;
+  }
+};
+```
+
+### 简单问候工具示例
+
+```javascript
+module.exports = {
+  validateName: function (name) {
+    if (!name) {
+      throw new TypeError('名称不能为空');
+    }
+    if (typeof name !== 'string') {
+      throw new TypeError('名称必须是字符串类型');
+    }
+    return name.trim();
+  },
+  
+  async main(params) {
+    let ret;
+    try {
+      let name = this.validateName(params.name);
+      ret = {
+        code: 0,
+        msg: '问候成功',
+        greeting: 'Hello, ' + name + '!'
+      };
+    } catch (error) {
+      ret = {
+        code: 10000,
+        msg: error.message
+      };
+    }
+    return ret;
+  }
+};
+```
+
+## 二、tool.json 完整配置示例
+
+```json
+{
+  "name": "tool_name",
+  "title": "工具中文标题",
+  "description": "工具描述，说明工具的用途",
+  "category": "工具分类",
+  "type": "function",
+  "main": "./index.js",
+  "params": [
+    {
+      "name": "param1",
+      "description": "参数1的描述",
+      "type": "string",
+      "required": true
+    },
+    {
+      "name": "param2",
+      "description": "参数2的描述",
+      "type": "number",
+      "default": 100
+    }
+  ],
+  "returns": [
+    {
+      "name": "code",
+      "type": "number",
+      "description": "状态码，0成功 其他失败",
+      "default": 0
+    },
+    {
+      "name": "msg",
+      "type": "string",
+      "description": "状态描述",
+      "default": ""
+    }
+  ]
+}
+```
+
+## 三、返回值格式标准
+
+### 成功（带返回数据）
+```javascript
+{
+  code: 0,
+  msg: '操作成功',
+  task: { name: 'task1', title: '任务1' },
+  total: 100
+}
+```
+
+### 成功（无数据）
+```javascript
+{
+  code: 0,
+  msg: '操作成功'
+}
+```
+
+### 失败（通用错误码）
+```javascript
+{
+  code: 10000,
+  msg: '错误描述信息'
+}
+```
+
+### 参数错误
+```javascript
+{
+  code: 10000,
+  msg: '参数错误: xxx 不能为空'
+}
+```
+
+## 四、标准错误码
+
+| 错误码 | 含义 | 使用场景 |
+|--------|------|----------|
+| `0` | 成功 | 操作正常完成 |
+| `10000` | 失败 | 参数错误、资源不存在、系统错误等通用错误 |
+
+## 五、工具目录结构
+
+```
+./ai/tool/{tool_name}/
+├── index.js       # 工具脚本（入口文件）
+└── tool.json      # 工具配置文件
+```
+
+## 六、常用工具分类参考
+
+| 分类 | 说明 | 示例工具 |
+|------|------|----------|
+| 图像处理 | 图片相关操作 | image_convert, image_resize |
+| 音频处理 | 音频相关操作 | audio_convert, audio_merge |
+| 视频处理 | 视频相关操作 | video_convert, video_merge |
+| 文本处理 | 文本相关操作 | text_translate, text_extract |
+| 文件管理 | 文件系统操作 | copy_file, delete_file |
+| 数据处理 | 数据处理操作 | excel_read, excel_write |
+| 画布绘图 | 图形绘制操作 | canvas_draw, canvas_image |
+| 任务管理 | 任务相关操作 | get_task_detail, create_task |

package/common/skill/tool/tool_test_data_generation/skill.json

@@ -0,0 +1,14 @@
+{
+  // 技能名称
+  "name": "tool_test_data_generation",
+  // 技能标题(显示用的中文名称)
+  "title": "工具测试数据生成",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "根据工具目录下的tool.json配置文件，自动生成test_data.json测试数据文件，用于工具功能测试",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 工具配置项
+  "tools": []
+}