momo-ai 1.0.19 → 1.0.21

package/.claude/skills/r2mo-rad-lain/examples/file-operations.js

@@ -0,0 +1,182 @@
+/**
+ * 文件操作示例
+ * 演示常用的文件操作模式
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const fsAsync = require('fs').promises;
+const { execSync } = require('child_process');
+
+// ============================================================
+// 递归拷贝目录
+// ============================================================
+
+const copyDirectory = async (src, dest) => {
+    // 确保目标目录存在
+    await fsAsync.mkdir(dest, { recursive: true });
+
+    const items = await fsAsync.readdir(src);
+
+    for (const item of items) {
+        const srcPath = path.join(src, item);
+        const destPath = path.join(dest, item);
+        const stat = await fsAsync.stat(srcPath);
+
+        if (stat.isDirectory()) {
+            await copyDirectory(srcPath, destPath);
+        } else {
+            await fsAsync.copyFile(srcPath, destPath);
+        }
+    }
+};
+
+// ============================================================
+// 扫描目录
+// ============================================================
+
+const scanDirectory = (dirPath, filter = () => true) => {
+    const results = [];
+
+    if (!fs.existsSync(dirPath)) {
+        return results;
+    }
+
+    const items = fs.readdirSync(dirPath);
+
+    for (const item of items) {
+        const itemPath = path.join(dirPath, item);
+        const stat = fs.statSync(itemPath);
+
+        if (stat.isDirectory() && filter(item, itemPath)) {
+            results.push({
+                name: item,
+                path: itemPath,
+                isDirectory: true
+            });
+        }
+    }
+
+    return results;
+};
+
+// ============================================================
+// 解析 YAML 头部 (Frontmatter)
+// ============================================================
+
+const parseYamlFrontmatter = (filePath) => {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+
+        const content = fs.readFileSync(filePath, 'utf8');
+        const lines = content.split('\n');
+
+        let inYaml = false;
+        let yamlLines = [];
+
+        for (const line of lines) {
+            if (line.trim() === '---') {
+                if (!inYaml) {
+                    inYaml = true;
+                    continue;
+                } else {
+                    break;
+                }
+            }
+            if (inYaml) {
+                yamlLines.push(line);
+            }
+        }
+
+        if (yamlLines.length === 0) {
+            return null;
+        }
+
+        // 简单 YAML 解析
+        const metadata = {};
+        let arrayKey = null;
+
+        for (const line of yamlLines) {
+            if (line.trim() === '') continue;
+
+            // 数组项
+            const arrayMatch = line.match(/^\s+-\s+(.+)$/);
+            if (arrayMatch && arrayKey) {
+                if (!metadata[arrayKey]) {
+                    metadata[arrayKey] = [];
+                }
+                metadata[arrayKey].push(arrayMatch[1].trim());
+                continue;
+            }
+
+            // 键值对
+            const kvMatch = line.match(/^(\w+):\s*(.*)$/);
+            if (kvMatch) {
+                const key = kvMatch[1];
+                const value = kvMatch[2].trim();
+
+                if (value === '') {
+                    arrayKey = key;
+                    metadata[key] = [];
+                } else {
+                    // 移除引号
+                    metadata[key] = value.replace(/^["']|["']$/g, '');
+                    arrayKey = null;
+                }
+            }
+        }
+
+        return metadata;
+    } catch (error) {
+        return null;
+    }
+};
+
+// ============================================================
+// 临时目录管理
+// ============================================================
+
+const createTempDir = (prefix = 'momo') => {
+    return path.join(os.tmpdir(), `.${prefix}-${Date.now()}`);
+};
+
+const cleanupTempDir = async (tempDir) => {
+    try {
+        if (tempDir && fs.existsSync(tempDir)) {
+            await fsAsync.rm(tempDir, { recursive: true, force: true });
+        }
+    } catch (error) {
+        console.warn(`清理临时目录失败: ${error.message}`);
+    }
+};
+
+// ============================================================
+// Git 操作
+// ============================================================
+
+const gitClone = (url, destDir) => {
+    try {
+        execSync(`git clone --depth 1 "${url}" "${destDir}"`, {
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        return true;
+    } catch (error) {
+        throw new Error(`克隆仓库失败: ${error.message}`);
+    }
+};
+
+// ============================================================
+// 导出
+// ============================================================
+
+module.exports = {
+    copyDirectory,
+    scanDirectory,
+    parseYamlFrontmatter,
+    createTempDir,
+    cleanupTempDir,
+    gitClone
+};

package/.claude/skills/r2mo-rad-lain/file-utils-api.md

@@ -0,0 +1,281 @@
+# 文件操作工具 API
+
+本文档描述 `scripts/file-utils.js` 和 `scripts/yaml-parser.js` 模块的完整 API。
+
+## file-utils.js
+
+### 快速开始
+
+```javascript
+const {
+    copyDir,
+    scanDir,
+    createTempDir,
+    cleanup,
+    ensureDir,
+    exists,
+    readJson,
+    writeJson,
+    gitClone
+} = require('./scripts/file-utils');
+```
+
+### API 参考
+
+#### copyDir(src, dest)
+
+递归拷贝目录。
+
+```javascript
+await copyDir('/source/path', '/dest/path');
+```
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| src | string | 源目录路径 |
+| dest | string | 目标目录路径 |
+
+**返回值：** Promise\<void\>
+
+#### scanDir(dirPath, filter?)
+
+扫描目录，返回子目录列表。
+
+```javascript
+// 扫描所有子目录
+const dirs = scanDir('/some/path');
+
+// 带过滤条件（排除隐藏目录）
+const dirs = scanDir('/path', (name) => !name.startsWith('.'));
+```
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| dirPath | string | 目录路径 |
+| filter | Function | 过滤函数 (name, fullPath) => boolean |
+
+**返回值：** Array\<{ name, path, isDirectory }\>
+
+#### createTempDir(prefix?)
+
+创建临时目录路径（不会实际创建目录）。
+
+```javascript
+const tempDir = createTempDir('my-task');
+// 返回: /tmp/.my-task-1234567890
+
+// 需要配合 ensureDir 或 gitClone 等实际创建
+await ensureDir(tempDir);
+```
+
+| 参数 | 类型 | 默认值 | 描述 |
+|------|------|--------|------|
+| prefix | string | 'momo' | 目录前缀 |
+
+**返回值：** string
+
+#### cleanup(dirPath)
+
+删除目录（递归）。
+
+```javascript
+await cleanup('/tmp/.momo-123');
+```
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| dirPath | string | 目录路径 |
+
+**返回值：** Promise\<boolean\> - 是否成功
+
+#### ensureDir(dirPath)
+
+确保目录存在（不存在则创建）。
+
+```javascript
+await ensureDir('/path/to/dir');
+```
+
+#### exists(filePath)
+
+检查文件或目录是否存在。
+
+```javascript
+if (exists('/path/to/file')) {
+    // ...
+}
+```
+
+#### readJson(filePath)
+
+读取 JSON 文件。
+
+```javascript
+const config = readJson('/path/config.json');
+if (config) {
+    console.log(config.name);
+}
+```
+
+**返回值：** Object | null
+
+#### writeJson(filePath, data, indent?)
+
+写入 JSON 文件。
+
+```javascript
+await writeJson('/path/config.json', { key: 'value' }, 2);
+```
+
+| 参数 | 类型 | 默认值 | 描述 |
+|------|------|--------|------|
+| filePath | string | - | 文件路径 |
+| data | Object | - | 要写入的数据 |
+| indent | number | 4 | 缩进空格数 |
+
+#### gitClone(url, destDir, options?)
+
+Git 克隆仓库。
+
+```javascript
+const tempDir = createTempDir('repo');
+try {
+    gitClone('https://github.com/user/repo.git', tempDir);
+    // 使用克隆的内容
+} finally {
+    await cleanup(tempDir);
+}
+```
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| url | string | 仓库 URL |
+| destDir | string | 目标目录 |
+| options.shallow | boolean | 是否浅克隆（默认 true） |
+
+**返回值：** boolean  
+**异常：** 失败时抛出 Error
+
+---
+
+## yaml-parser.js
+
+### 快速开始
+
+```javascript
+const { parseFile, parseYaml, extractBody } = require('./scripts/yaml-parser');
+```
+
+### API 参考
+
+#### parseFile(filePath)
+
+从文件中解析 YAML Frontmatter。
+
+```javascript
+const metadata = parseFile('/path/to/SKILL.md');
+if (metadata) {
+    console.log(metadata.name);
+    console.log(metadata.description);
+}
+```
+
+**返回值：** Object | null
+
+#### parseYaml(yamlStr)
+
+解析 YAML 字符串。
+
+```javascript
+const yaml = `
+name: my-skill
+version: 1.0.0
+tags:
+  - tag1
+  - tag2
+`;
+const obj = parseYaml(yaml);
+// { name: 'my-skill', version: '1.0.0', tags: ['tag1', 'tag2'] }
+```
+
+**支持的格式：**
+- 简单键值对: `key: value`
+- 带引号值: `key: "value"` 或 `key: 'value'`
+- 数组（缩进列表）
+- 布尔值: `true`, `false`
+- 数字: `123`, `1.23`
+
+**不支持：**
+- 嵌套对象
+- 多行字符串
+- 复杂 YAML 语法
+
+#### parseContent(content)
+
+从字符串内容中解析 YAML Frontmatter。
+
+```javascript
+const content = fs.readFileSync('file.md', 'utf8');
+const metadata = parseContent(content);
+```
+
+#### extractBody(content)
+
+提取 Frontmatter 之后的正文内容。
+
+```javascript
+const content = fs.readFileSync('file.md', 'utf8');
+const body = extractBody(content);
+console.log(body); // Markdown 正文
+```
+
+---
+
+## 常用模式
+
+### 临时目录工作流
+
+```javascript
+const { createTempDir, cleanup, gitClone, scanDir } = require('./scripts/file-utils');
+
+const tempDir = createTempDir('task');
+
+try {
+    // 克隆仓库
+    gitClone('https://github.com/user/repo.git', tempDir);
+    
+    // 扫描目录
+    const items = scanDir(path.join(tempDir, 'skills'));
+    
+    // 处理内容...
+    
+} finally {
+    // 确保清理
+    await cleanup(tempDir);
+}
+```
+
+### 技能扫描模式
+
+```javascript
+const { scanDir } = require('./scripts/file-utils');
+const { parseFile } = require('./scripts/yaml-parser');
+const path = require('path');
+
+const scanSkills = (skillsDir) => {
+    const dirs = scanDir(skillsDir);
+    
+    return dirs.map(dir => {
+        const skillFile = path.join(dir.path, 'SKILL.md');
+        const metadata = parseFile(skillFile);
+        
+        return {
+            dirname: dir.name,
+            path: dir.path,
+            name: metadata?.name || dir.name,
+            description: metadata?.description || '无描述',
+            version: metadata?.version || '未知'
+        };
+    });
+};
+```

package/.claude/skills/r2mo-rad-lain/menu-api.md

@@ -0,0 +1,187 @@
+# 交互式菜单 API
+
+本文档描述 `scripts/menu.js` 模块的完整 API。该模块提供统一的交互式选择菜单功能。
+
+## 快速开始
+
+```javascript
+const { selectMultiple, selectSingle } = require('./scripts/menu');
+
+// 多选菜单
+const items = [
+    { name: 'option-1', description: '第一个选项' },
+    { name: 'option-2', description: '第二个选项' }
+];
+const result = await selectMultiple(items, '请选择');
+
+// 单选菜单
+const selected = await selectSingle(items, '选择一个');
+```
+
+## API 参考
+
+### selectMultiple(items, title, options)
+
+创建多选菜单，支持空格选择、全选、清空等操作。
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 描述 |
+|------|------|------|------|
+| items | Array\<Object\> | 是 | 菜单项列表 |
+| items[].name | string | 是 | 项目名称 |
+| items[].description | string | 否 | 项目描述 |
+| title | string | 否 | 菜单标题，默认 '选择菜单' |
+| options | Object | 否 | 配置选项 |
+| options.showIndex | boolean | 否 | 是否显示序号，默认 false |
+| options.allowEmpty | boolean | 否 | 是否允许空选择，默认 false |
+
+**返回值：**
+
+```javascript
+{
+    indices: number[],  // 选中项的索引
+    items: Object[]     // 选中的项
+}
+```
+
+**操作说明：**
+
+| 按键 | 功能 |
+|------|------|
+| ↑/↓ | 上下移动光标 |
+| 空格 | 选择/取消当前项 |
+| a | 全选 |
+| n | 清空选择 |
+| 回车 | 确认选择 |
+| q/ESC | 退出（返回空结果） |
+
+**示例：**
+
+```javascript
+const items = [
+    { name: 'skill-1', description: '技能描述一' },
+    { name: 'skill-2', description: '技能描述二' },
+    { name: 'skill-3', description: '技能描述三' }
+];
+
+const result = await selectMultiple(items, '选择要安装的技能', {
+    showIndex: true,
+    allowEmpty: false
+});
+
+if (result.items.length > 0) {
+    console.log('选中的技能:');
+    result.items.forEach(item => {
+        console.log(`  - ${item.name}`);
+    });
+}
+```
+
+### selectSingle(items, title)
+
+创建单选菜单，只能选择一项。
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 描述 |
+|------|------|------|------|
+| items | Array\<Object\> | 是 | 菜单项列表 |
+| items[].name | string | 是 | 项目名称 |
+| items[].description | string | 否 | 项目描述 |
+| title | string | 否 | 菜单标题 |
+
+**返回值：**
+
+- 选中的项（Object）
+- 取消时返回 `null`
+
+**操作说明：**
+
+| 按键 | 功能 |
+|------|------|
+| ↑/↓ | 上下移动光标 |
+| 回车 | 确认选择 |
+| q/ESC | 退出（返回 null） |
+
+**示例：**
+
+```javascript
+const repos = [
+    { name: 'repo-1', description: '仓库一' },
+    { name: 'repo-2', description: '仓库二' }
+];
+
+const selected = await selectSingle(repos, '选择仓库');
+if (selected) {
+    console.log(`已选择: ${selected.name}`);
+} else {
+    console.log('已取消');
+}
+```
+
+### clearScreen()
+
+清屏并将光标移动到顶部。
+
+```javascript
+const { clearScreen } = require('./scripts/menu');
+clearScreen();
+```
+
+## 使用模式
+
+### 菜单 + 确认模式
+
+推荐将菜单选择和确认分离：
+
+```javascript
+const Ec = require('../epic');
+const { selectMultiple } = require('./scripts/menu');
+
+// 1. 菜单选择（raw mode）
+const result = await selectMultiple(items, '选择菜单');
+
+if (result.items.length === 0) {
+    Ec.waiting('未选择任何项');
+    process.exit(0);
+}
+
+// 2. 确认（普通输入模式）
+const answer = await Ec.ask('确认操作？(y/N): ');
+if (answer.toLowerCase() !== 'y') {
+    Ec.waiting('已取消');
+    process.exit(0);
+}
+
+// 3. 执行操作
+```
+
+### 注意事项
+
+1. **不要在菜单操作中使用 Ec.ask**：菜单使用 raw mode，与 Ec.ask 的 readline 冲突
+2. **菜单完成后才能使用 Ec.ask**：菜单函数返回后已退出 raw mode
+3. **Ctrl+C 会直接退出进程**：这是预期行为，确保用户可以随时终止
+
+## 自定义扩展
+
+如需自定义菜单样式，可以基于 `selectMultiple` 的实现进行修改。关键点：
+
+```javascript
+// 1. 启用 raw mode
+readline.emitKeypressEvents(process.stdin);
+process.stdin.setRawMode(true);
+
+// 2. 渲染菜单
+const render = () => {
+    process.stdout.write('\x1B[2J\x1B[0f'); // 清屏
+    // ... 绘制菜单
+};
+
+// 3. 监听按键
+process.stdin.on('keypress', onKeypress);
+
+// 4. 退出时恢复
+process.stdin.setRawMode(false);
+process.stdin.removeListener('keypress', onKeypress);
+```