feishu-user-md

# Feishu User.md Reader - 飞书任务清单查询

实时读取 `~/.openclaw/workspace/USER.md`，解析任务清单并格式化为分类列表返回。

## 核心功能

### 实时任务解析
从 `~/.openclaw/workspace/USER.md` 读取三类数据源：
1. **常规任务清单表格** → 提取任务名、频率、技能名、描述
2. **日常自动化表格** → 提取定时任务时间和名称
3. **手动触发指令表格** → 提取触发词映射

### 智能分类
任务按用途自动归类：
- 📝 **内容创作** — 图片提示词、API图片、知识漫画、信息图
- 📕 **小红书运营** — 完整运营、发布、卡片生成
- 📤 **内容发布** — 微信公众号、Markdown转HTML
- 🔧 **工具** — 翻译、图片压缩、网页抓取、数据导出
- 📰 **新闻与SEO** — 添加/撰写新闻、SEO文章
- 📂 **日常管理** — 对话归档、Token统计、周报、日历
- 📁 **其他** — 未匹配的任务

### 输出格式

**注意**：返回内容动态读取 USER.md 实际内容，不硬编码。

```
📋 您的任务清单（共N项）

【定时自动化】
• 0:00 对话记录自动归档
• 9:00 Token日报生成

【内容创作】
• 图片提示词生成 - 说"生成图片提示词"
• API图片生成 - 说"生成图片"

💡 直接发送任务关键词即可触发
```

## 触发指令

| 指令 | 说明 |
|------|------|
| `查看任务` | 基础触发指令 |
| `我的任务` | 简写形式 |
| `有什么技能` | 查看可用技能 |
| `帮助` / `?` | 帮助信息 |

## 使用方法

```bash
node scripts/feishu-user-md.js read   # 格式化输出
node scripts/feishu-user-md.js json   # JSON 输出
```

## 技术实现

- Node.js 脚本，仅使用内置模块（`fs`、`path`、`os`），无第三方依赖
- 正则表达式解析 Markdown 表格
- 按关键词自动归类任务
- 每次调用**实时读取** USER.md，无缓存

### 解析流程
1. `readUserMd()` — 读取文件内容
2. `parseUserMd(content)` — 提取常规任务、定时任务、触发指令
3. `categorize(tasks)` — 按用途关键词分类
4. `formatForFeishu(data)` — 格式化为飞书消息文本

## 文件位置

- **技能目录**: `skills/feishu-user-md/`
- **脚本文件**: `skills/feishu-user-md/scripts/feishu-user-md.js`
- **数据源**: `~/.openclaw/workspace/USER.md`

## 注意事项

1. **无缓存** — 每次调用都实时读取 USER.md，更新后立即生效
2. **动态触发** — 所有触发指令从 USER.md 的"手动触发指令"表格动态读取
3. **自动同步** — 新增/删除任务只需...

# 飞书任务清单查询

实时读取 `USER.md`，解析任务清单并以分类格式返回，让飞书用户快速了解所有可用任务和技能。

## 安装

```bash
clawhub install feishu-user-md
```

或手动安装：将整个文件夹复制到 `~/.openclaw/skills/feishu-user-md/`。

## 功能特性

- **实时解析**：每次调用动态读取 USER.md，无缓存，更新后立即生效
- **智能分类**：按内容创作、小红书运营、内容发布、工具、新闻与SEO 等类别自动归类
- **触发词映射**：自动提取手动触发指令，展示每个任务的触发方式
- **零依赖**：仅使用 Node.js 内置模块，无需安装第三方包

## 项目结构

```
feishu-user-md/
├── SKILL.md                    # 技能说明（ClawHub 必需）
├── claw.json                   # ClawHub 清单文件
├── README.md                   # 项目文档
└── scripts/
    └── feishu-user-md.js       # 主脚本（读取、解析、格式化）
```

## 使用方式

### 命令行

```bash
node scripts/feishu-user-md.js read   # 格式化输出
node scripts/feishu-user-md.js json   # JSON 输出
```

### 飞书触发

直接在飞书中发送以下指令：
- "查看任务" / "我的任务"
- "有什么技能"
- "帮助" / "?"

## 数据源

所有数据来自 `~/.openclaw/workspace/USER.md`，包含三类表格：
- **常规任务清单**（序号、名称、频率、技能、描述）
- **日常自动化**（时间、任务名、技能）
- **手动触发指令**（任务名、触发词）

新增或删除任务只需修改 USER.md，飞书端自动同步。

## 前置条件

- OpenClaw 已安装并运行
- `~/.openclaw/workspace/USER.md` 文件存在且包含任务清单表格

## 技术栈

- Node.js（仅内置模块：`fs`、`path`、`os`）