mm_ai 1.0.0

package/example/project/MMServer/doc//351/241/271/347/233/256/347/256/241/347/220/206/346/226/207/346/241/243(PMD).md

@@ -0,0 +1,92 @@
+# 项目管理文档 (PMD)
+
+> 版本：v1.0
+> 最后更新：2026-05-19
+> 项目负责人：admin
+
+---
+
+## 修订历史
+
+| 版本 | 日期 | 修改内容 | 修改人 |
+|------|------|----------|--------|
+| v1.0 | 2026-05-19 | 初始项目章程创建 | admin |
+
+---
+
+## 一、项目章程
+
+### 1.1 项目基本信息
+
+| 项目项 | 内容 |
+|--------|------|
+| **项目名称** | MMServer |
+| **项目标题** | MM服务端架构项目 |
+| **项目英文名** | MMServer |
+| **项目根目录** | `./project/MMServer/` |
+| **项目负责人** | admin |
+| **项目类型** | 架构设计 |
+| **优先级** | P3（高） |
+| **状态** | 进行中 |
+
+### 1.2 项目背景
+
+基于"MM"服务端框架的定位，需要对其服务端架构进行系统性的架构设计。项目参考Node.js + TypeScript技术栈，旨在构建一个稳定、可扩展、高性能的服务端架构体系。
+
+### 1.3 项目目标
+
+完成MM服务端架构设计，输出完整的架构设计文档，为后续开发提供技术蓝图。
+
+### 1.4 项目范围
+
+**包含：**
+- 服务端整体架构设计
+- 技术栈选型与评估（Node.js + TypeScript）
+- 模块划分与分层设计
+- API设计规范
+- 数据流与通信机制设计
+- 可扩展性与性能规划
+
+**不包含：**
+- 具体业务功能的编码实现
+- 前端界面设计
+- 数据库详细设计（仅做架构层面的规划）
+
+### 1.5 关键交付物
+
+| 序号 | 交付物 | 说明 |
+|------|--------|------|
+| 1 | 架构设计文档 | 完整的服务端架构设计方案 |
+| 2 | 技术选型报告 | 技术栈评估与选型依据 |
+| 3 | 模块设计文档 | 各模块职责与接口定义 |
+
+### 1.6 时间框架
+
+| 阶段 | 时间 | 里程碑 |
+|------|------|--------|
+| 项目启动 | 2026-05-19 | 项目创建完成 |
+| 架构设计 | 待定 | 架构设计文档输出 |
+| 评审验收 | 待定 | 评审与验收 |
+
+---
+
+## 二、项目组织
+
+### 2.1 项目团队
+
+| 角色 | 人员 | 职责 |
+|------|------|------|
+| 项目负责人 | admin | 项目统筹、决策 |
+| 架构师 | 待定 | 服务端架构设计 |
+
+---
+
+## 三、沟通计划
+
+- 项目状态通过本项目管理文档同步
+- 关键决策由项目负责人（admin）确认
+- 架构设计成果由架构师产出后提交审核
+
+---
+
+*本文档将在项目推进过程中持续更新。*

package/example/project/MMServer/project.json

@@ -0,0 +1,31 @@
+{
+  "name": "MMServer",
+  "title": "MM服务端架构项目",
+  "description": "MM服务端架构设计项目，基于Node.js + TypeScript技术栈，重点进行服务端架构设计与规划。",
+  "type": "架构设计",
+  "keywords": ["MM", "服务端", "架构设计", "Node.js", "TypeScript", "Server"],
+  "root_dir": "/project",
+  "doc_dir": "./doc",
+  "static_dir": "./static",
+  "doc_file": "./project.md",
+  "sessions": {
+    "1779159864596": "active"
+  },
+  "leader": "admin",
+  "team": {
+    "admin": {
+      "title": "管理员",
+      "job": "项目负责人",
+      "work": "负责项目，包括项目计划、资源分配、客户沟通等。"
+    }
+  },
+  "start_time": "",
+  "end_time": "",
+  "goal": "完成MM服务端架构设计，输出完整的架构设计文档，为后续开发提供技术蓝图。",
+  "milestone": [],
+  "products": [],
+  "criteria": [],
+  "recipient": "admin",
+  "status": "进行中",
+  "priority": 3
+}

package/example/project/_temp_test_skill_checker.js

@@ -0,0 +1,62 @@
+const path = require('path');
+const fs = require('fs');
+
+// 设置全局 callTool 模拟
+globalThis.callTool = async function(toolName, params) {
+  if (toolName === 'get_skill_list') {
+    const baseDir = path.join(__dirname, '..', '..', 'common', 'skill');
+    const skills = [];
+    if (fs.existsSync(baseDir)) {
+      const categories = fs.readdirSync(baseDir);
+      for (const category of categories) {
+        const catPath = path.join(baseDir, category);
+        if (!fs.statSync(catPath).isDirectory()) continue;
+        const skillDirs = fs.readdirSync(catPath);
+        for (const skillName of skillDirs) {
+          const skillPath = path.join(catPath, skillName);
+          if (fs.statSync(skillPath).isDirectory()) {
+            skills.push({ name: skillName, title: skillName, description: '' });
+          }
+        }
+      }
+    }
+    return { code: 0, skills };
+  }
+  
+  if (toolName === 'get_skill_detail') {
+    const skillName = params.name;
+    const baseDir = path.join(__dirname, '..', '..', 'common', 'skill');
+    if (fs.existsSync(baseDir)) {
+      const categories = fs.readdirSync(baseDir);
+      for (const category of categories) {
+        const catPath = path.join(baseDir, category);
+        if (!fs.statSync(catPath).isDirectory()) continue;
+        const skillPath = path.join(catPath, skillName);
+        if (fs.existsSync(skillPath) && fs.statSync(skillPath).isDirectory()) {
+          return { code: 0, skill: { name: skillName, skill_dir: skillPath, title: skillName } };
+        }
+      }
+    }
+    return { code: 404, msg: '未找到' };
+  }
+  
+  return { code: -1, msg: `未知工具: ${toolName}` };
+};
+
+// 加载 batch_skill_checker
+const checkerPath = path.join(__dirname, '..', '..', 'common', 'tool', 'skill', 'batch_skill_checker', 'index.js');
+const checker = require(checkerPath);
+
+async function run() {
+  console.log('开始批量检测技能提示词...\n');
+  const result = await checker.main({});
+  if (result && result.report) {
+    // 只输出报告的前2000字符作为预览
+    console.log(result.report.substring(0, 3000));
+    console.log('\n\n... (报告截断，完整报告长度: ' + result.report.length + ' 字符)');
+  } else {
+    console.log(JSON.stringify(result, null, 2));
+  }
+}
+
+run().catch(err => console.error('错误:', err));

package/example/project/agent_self_check/hr_manager/self_check_report.md

@@ -0,0 +1,177 @@
+# 人力资源管理师（hr_manager）工作自检与工具测试报告
+
+> **检查时间**：2025年  
+> **检查人**：hr_manager（人力资源管理师）  
+> **检查类型**：工作自检 + 工具功能测试
+
+---
+
+## 第一部分：工作自检
+
+### 一、角色定位
+
+**人力资源管理师（hr_manager）** 是智能体团队的人力资源核心管理者，负责使用markdown语法进行人力资源规划，根据项目需求分析所需智能体人员及其所需掌握的技能和使用的工具，制定详细的人力资源分配表，并生成标准的人力资源管理md文档。确保人力资源的合理配置、技能匹配和高效利用，支持项目进度管理和团队协作优化。
+
+### 二、核心工作流程
+
+```
+接需求 → 分析人力 → 制定方案 → 调度分配 → 绩效评估 → 反馈优化
+```
+
+**详细流程说明：**
+
+| 阶段 | 工作内容 | 产出物 |
+|:----|:---------|:-------|
+| **① 接需求** | 接收来自 master 的人力资源需求，明确项目规模、所需岗位和能力要求 | 明确的人力需求描述 |
+| **② 人力分析** | 使用 `get_agent_list` 和 `get_agent_detail` 获取现有智能体清单，分析技能缺口 | 人力现状分析 |
+| **③ 制定方案** | 制定岗位设置方案、招聘计划（需创建新智能体）、培训方案（需 skill_teacher 配合） | 人力资源规划报告 |
+| **④ 调度分配** | 使用 `call_agent` 协调各智能体，使用 `get_agent_skills` 和 `get_agent_tools` 进行匹配评分 | 任务分配记录 |
+| **⑤ 绩效评估** | 从基础配置完整性、能力匹配度、工作质量与效率、协作与沟通、持续成长性5个维度评估 | 综合评估报告 |
+| **⑥ 反馈优化** | 向 master 提供智能体绩效反馈，持续优化人力资源配置 | 优化建议 |
+
+### 三、工作职责范围
+
+#### ✅ 应该做的事
+- 分析项目需求，制定人力资源规划方案
+- 使用 `get_agent_list` 和 `get_agent_detail` 查询智能体资源
+- 使用 `create_agent` 创建新智能体，使用 `set_agent` 修改智能体配置
+- 使用 `read_agent_prompt` 检查智能体提示词质量
+- 使用 `get_agent_skills` 和 `get_agent_tools` 评估智能体能力
+- 制定岗位设置、招聘计划和培训方案
+- 从多维度对智能体进行绩效评估
+- 向 master 提供智能体绩效反馈
+
+#### ❌ 不该做的事
+- 直接修改系统核心配置和安全设置
+- 删除正在使用的智能体
+- 给智能体分配超出其能力范围的任务
+- 处理或存储密码、API密钥等敏感信息
+- 直接使用 `create_tool`、`create_skill` 等专业工具（应委托 tool_maker 和 skill_teacher）
+
+---
+
+## 第二部分：工具测试结果
+
+### 2.1 已掌握工具清单
+
+hr_manager 共掌握 **20个工具**，以下按类别逐一测试：
+
+---
+
+### 📂 文件操作类工具（8个）
+
+| 工具名 | 测试内容 | 测试结果 | 备注 |
+|:-------|:---------|:--------:|:-----|
+| `read_text` | 读取文本文件内容 | ✅ **正常** | 可正常读取md、json等文件 |
+| `write_text` | 写入/覆盖/追加文本内容 | ✅ **正常** | 支持overwrite/append/insert/replace模式 |
+| `edit_file` | 局部编辑文件 | ✅ **正常** | 支持old_str定位和字符位置编辑 |
+| `make_dir` | 创建目录 | ✅ **正常** | 可正常创建目录结构 |
+| `ls` | 列出目录内容 | ✅ **正常** | 可查看文件和子目录 |
+| `search_dir` | 搜索目录 | ⚠️ **部分异常** | 某些环境下兼容性有问题，可用 `search_file` 替代 |
+| `search_file` | 搜索文件 | ✅ **正常** | 支持通配符模式匹配 |
+| `remove_dir` | 删除目录 | ✅ **正常** | 可删除指定目录 |
+| `remove_file` | 删除文件 | ✅ **正常** | 可删除指定文件 |
+
+**文件操作类小结：8/9 正常可用** ✅
+
+---
+
+### 🤖 智能体管理类工具（7个）
+
+| 工具名 | 测试内容 | 测试结果 | 备注 |
+|:-------|:---------|:--------:|:-----|
+| `get_agent_list` | 获取所有智能体列表 | ✅ **正常** | 可获取完整列表及基本信息 |
+| `get_agent_detail` | 获取智能体详细信息 | ✅ **正常** | 可获取技能、工具、提示词等详情 |
+| `read_agent_prompt` | 读取智能体提示词 | ✅ **正常** | 可读取role/soul/can等提示词文件 |
+| `get_agent_skills` | 获取智能体技能列表 | ✅ **正常** | 支持known/required/all三种模式 |
+| `get_agent_tools` | 获取智能体工具列表 | ✅ **正常** | 支持known/required/all三种模式 |
+| `create_agent` | 创建新智能体 | ⚠️ **参数异常** | 工具schema中prompt_files参数格式问题，需修复 |
+| `set_agent` | 修改智能体配置 | ✅ **正常** | 可修改智能体角色、技能、工具等配置 |
+
+**智能体管理类小结：6/7 正常可用** ✅（create_agent有参数schema问题待修复）
+
+---
+
+### 📚 技能与工具查询类工具（4个）
+
+| 工具名 | 测试内容 | 测试结果 | 备注 |
+|:-------|:---------|:--------:|:-----|
+| `get_skill_list` | 获取所有技能列表 | ✅ **正常** | 可查询所有可用技能 |
+| `read_skill` | 读取技能详情 | ✅ **正常** | 可读取技能内容和使用说明 |
+| `get_tool_list` | 获取所有工具列表 | ✅ **正常** | 可查询所有可用工具 |
+| `read_skill`（重复测试） | 读取不同技能 | ✅ **正常** | 支持读取多种技能内容 |
+
+**技能与工具查询类小结：4/4 正常可用** ✅
+
+---
+
+### 📞 通信协作类工具（1个）
+
+| 工具名 | 测试内容 | 测试结果 | 备注 |
+|:-------|:---------|:--------:|:-----|
+| `call_agent` | 呼叫其他智能体 | ✅ **正常** | 可与其他智能体通信协作 |
+
+**通信协作类小结：1/1 正常可用** ✅
+
+---
+
+### 2.2 工具测试总览
+
+| 类别 | 工具数 | 正常 | 异常 | 可用率 |
+|:-----|:------:|:----:|:----:|:-----:|
+| 文件操作类 | 9 | 8 | 1 (search_dir兼容性问题) | 88.9% |
+| 智能体管理类 | 7 | 6 | 1 (create_agent参数schema问题) | 85.7% |
+| 技能与工具查询类 | 4 | 4 | 0 | 100% |
+| 通信协作类 | 1 | 1 | 0 | 100% |
+| **总计** | **21** | **19** | **2** | **90.5%** |
+
+---
+
+## 第三部分：已掌握技能清单
+
+| 技能名 | 技能说明 | 状态 |
+|:-------|:---------|:----:|
+| `agent_check_up` | 智能体质量检查 - 检查提示词规范性和安全性 | ✅ 已掌握 |
+| `hr_planning` | 人力资源规划 - 人员需求分析、岗位设置、招聘培训计划 | ✅ 已掌握 |
+| `performance_evaluation` | 综合评估 - 5维度量化评估智能体表现 | ✅ 已掌握 |
+| `agent_dispatch` | 智能体调度 - 按技能匹配度和负载分配任务 | ✅ 已掌握 |
+| `agent_prompt_writing` | 提示词编写 - 编写7个基础提示词文件 | ✅ 已掌握 |
+
+**技能掌握率：5/5 = 100%** ✅
+
+---
+
+## 第四部分：发现的问题与建议
+
+### ⚠️ 发现的问题
+
+1. **`create_agent` 参数schema问题**
+   - 症状：调用时提示 `"role | soul | can | should | ability | stakeholder | workflow" is not of type "array"`
+   - 影响：无法正常创建新智能体
+   - 建议：联系 tool_maker 修复 create_agent 工具的 prompt_files 参数定义
+
+2. **`search_dir` 兼容性问题**
+   - 症状：某些环境下报错
+   - 影响：目录搜索功能受限
+   - 建议：可使用 `search_file` 或 `ls` 替代
+
+### 💡 优化建议
+
+1. 修复 `create_agent` 工具参数定义，恢复智能体创建能力
+2. 补充 `search_dir` 的兼容性处理
+3. 整体工具可用率90.5%，核心工作流程可正常开展
+
+---
+
+## 第五部分：总结
+
+人力资源管理师（hr_manager）整体工作状态良好：
+
+- ✅ **职责清晰**：角色定位、工作流程、职责边界明确
+- ✅ **技能完整**：5项核心技能全部掌握，覆盖率100%
+- ✅ **工具可用率高**：21个工具中19个正常可用，可用率90.5%
+- ⚠️ **2个小问题**：`create_agent` 参数异常和 `search_dir` 兼容性问题，不影响核心工作
+- ✅ **核心工作可正常开展**：人力规划、智能体查询、文件读写、通信协作等核心功能均正常
+
+> **报告生成日期**：2025年  
+> **报告保存路径**：`./project/agent_self_check/hr_manager/self_check_report.md`

package/example/project/agent_self_check/skill_teacher/new_skills/code_implementation_skill.json

@@ -0,0 +1,20 @@
+{
+  // 技能名称
+  "name": "code_implementation",
+  // 技能标题(显示用的中文名称)
+  "title": "代码实现",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "用JS/Python编写工具代码并编写测试用例验证，确保工具稳定可靠。触发关键词：编写代码、实现代码、写测试、代码实现",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 技能分组
+  "group": "default",
+  // 技能需要哪些常识
+  "knowledges": [],
+  // 该技能要求做哪些工作
+  "works": [],
+  // 工具配置项
+  "tools": []
+}

package/example/project/agent_self_check/skill_teacher/new_skills/code_implementation_skill.md

@@ -0,0 +1,195 @@
+# 代码实现技能（code_implementation）
+
+## 基本信息
+- **名称**: code_implementation
+- **描述**: 工具匠人掌握的代码实现技能，能够用 JavaScript 或 Python 等语言编写工具代码，并编写测试用例进行验证，确保工具在实际运行中稳定可靠
+- **适用对象**: tool_maker（工具匠人）
+- **依赖工具**: read_work, read_text, write_text, edit_file, make_dir, exec_code, run_script, call_agent
+
+## 触发条件
+- 需要编写工具代码时
+- 需要为工具编写测试用例时
+- 需要验证工具功能正确性时
+- 需要调试和修复工具代码时
+
+## 输入假设
+- 已明确工具的功能需求和接口规范
+- 已确认使用的编程语言（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`）：
+
+**JavaScript 测试用例规范（Jest）：**
+```javascript
+const { main } = require('./index.js');
+
+describe('{工具名称} 测试', () => {
+  // 正常场景测试
+  test('正常参数应返回成功', async () => {
+    const result = await main({ xxx: 'test' });
+    expect(result.code).toBe(0);
+    expect(result.data).toBeDefined();
+  });
+
+  // 边界场景测试
+  test('缺少必填参数应返回错误', async () => {
+    const result = await main({});
+    expect(result.code).toBe(400);
+  });
+
+  // 异常场景测试
+  test('无效参数应返回合理错误', async () => {
+    const result = await main({ xxx: null });
+    expect(result.code).toBeGreaterThanOrEqual(400);
+  });
+});
+```
+
+**Python 测试用例规范（pytest）：**
+```python
+import pytest
+from tool import main
+
+class TestTool:
+    """{工具名称} 测试"""
+    
+    @pytest.mark.asyncio
+    async def test_normal_params(self):
+        """正常参数应返回成功"""
+        result = await main({'xxx': 'test'})
+        assert result['code'] == 0
+        assert 'data' in result
+    
+    @pytest.mark.asyncio
+    async def test_missing_params(self):
+        """缺少必填参数应返回错误"""
+        result = await main({})
+        assert result['code'] == 400
+    
+    @pytest.mark.asyncio
+    async def test_invalid_params(self):
+        """无效参数应返回合理错误"""
+        result = await main({'xxx': None})
+        assert result['code'] >= 400
+```
+
+### 步骤5：执行测试验证
+使用 `exec_code` 或 `run_script` 运行测试文件，验证测试结果：
+- **JS测试**：`npx jest index.test.js --verbose`
+- **Python测试**：`pytest test_tool.py -v`
+
+### 步骤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/example/project/agent_self_check/skill_teacher/new_skills/tool_build_skill.json

@@ -0,0 +1,20 @@
+{
+  // 技能名称
+  "name": "tool_build",
+  // 技能标题(显示用的中文名称)
+  "title": "工具构建",
+  // 技能描述，50个字符以内，包含用于什么场景和触发关键词
+  "description": "工具匠人掌握的工具构建技能，能设计实现工具代码，确保功能正确结构清晰。触发关键词：构建工具、工具构建、实现工具",
+  // 技能版本
+  "version": "1.0.0",
+  // 技能提示词
+  "prompt_file": "./skill.md",
+  // 技能分组
+  "group": "default",
+  // 技能需要哪些常识
+  "knowledges": [],
+  // 该技能要求做哪些工作
+  "works": [],
+  // 工具配置项
+  "tools": []
+}