commit 53c1658b38950484046c2338bd753a6de1eedcc9
Author: OpenClaw Skill Sync Bot <bot@valavala.com>
Date:   Thu Apr 16 10:35:03 2026 +0800

    auto-sync: user-feedback-collector 2026-04-16_10:35

diff --git a/SKILL.md b/SKILL.md
new file mode 100644
index 0000000..001d174
--- /dev/null
+++ b/SKILL.md
@@ -0,0 +1,154 @@
+---
+name: user-feedback-collector
+description: |
+  全渠道用户反馈收集与管理，支持三类反馈数据源：
+  1. 主动上报：用户发送包含"用户反馈:"或"用户反馈："开头的消息时自动记录
+  2. 飞书内部反馈群：「内容测试问题反馈」群（oc_fabff7672e62a9ced7b326ee4a286c26），每6小时同步到飞书表格
+  3. 微信用户反馈群：数据实时存储在MySQL vala_test.wechat_group_message表
+  自动汇总、分类、统计反馈，支持同步到知识库文档、多维表格，生成周报/月报。
+---
+
+# 用户反馈收集与管理
+
+当用户发送的消息以 `用户反馈:` 或 `用户反馈：` 开头时，对反馈内容进行总结梳理后记录到飞书知识库文档。
+
+## 文档价值与内容匹配说明
+
+该文档用于集中收集「瓦拉英语」产品的各类问题与建议，便于后续统一筛选、统计与优化。
+
+当前主要反馈渠道包括：飞书群、微信群。
+
+为保证不同渠道的数据能以同一口径落到表格中，整理/写入时按以下规则进行字段匹配：
+
+| 字段 | 填写规则（统一口径） |
+| --- | --- |
+| 反馈渠道 | 固定枚举：`主动上报` / `飞书群` / `微信群` |
+| 反馈时间 | 以原消息时间为准（Asia/Shanghai） |
+| 提交人 | 优先填可识别的姓名/昵称；若无姓名则填平台昵称 |
+| 用户电话 | 若渠道中无法获取则留空 |
+| 用户角色ID | 若渠道中无法获取则留空 |
+| 文字描述 | 填问题的文字描述（可为原文或整理后的关键信息） |
+| 提交图片 | 有则填图片链接/文件引用；无则留空 |
+| 提交视频 | 有则填视频链接/文件引用；无则留空 |
+| 备注 | 可补充：复现路径、期望结果、影响范围、关联版本、群聊上下文摘要等 |
+| 评估后优先级 | 按 `P0/P1/P2/P3` 口径评估后填写；暂未评估可留空 |
+| 问题所属模块 | 按产品模块归类（例如：登录/课程/练习/支付/AI对话/数据统计等） |
+| 问题所属类型 | 建议枚举：`Bug` / `体验问题` / `功能需求` / `内容问题` / `性能问题` / `其他` |
+| 当前解决进度 | 建议枚举：`待确认` / `处理中` / `待发布` / `已解决` / `已关闭` |
+| 问题跟进人 | 填负责跟进该条问题的负责人（姓名/账号） |
+
+## 用户反馈收集表格（模板）
+
+| 序号 | 评估后优先级 | 问题所属模块 | 问题所属类型 | 反馈时间 | 反馈渠道 | 提交人 | 用户电话 | 用户角色ID | 文字描述 | 提交图片 | 提交视频 | 备注 | 当前解决进度 | 问题跟进人 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 1 |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| 2 |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| 3 |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| 4 |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| 5 |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+
+## 反馈数据源（全渠道）
+
+| 反馈渠道 | 来源 | 存储位置 | 更新频率 |
+|---------|------|----------|----------|
+| 主动上报 | 用户主动发送 `用户反馈:` 前缀消息 | 飞书知识库文档 | 实时 |
+| 飞书内部测试反馈 | 「内容测试问题反馈」群（`oc_fabff7672e62a9ced7b326ee4a286c26`） | 飞书表格：`E8vFsCmPBhT4SCtNmnJchqeJnJe` | 每6小时自动同步 |
+| 微信用户反馈 | 微信用户反馈群 | MySQL：`vala_test.wechat_group_message` 表 | 实时更新 |
+
+## 目标存储位置
+
+### 1. 主动上报知识库文档
+- **文档标题：** 2026年 用户反馈收集
+- **Wiki Token：** `SB3dwaSshie7ifklKlLc2GswnqX`
+- **Obj Token：** `NVCRdIChwot7oPxcpopcBFMOned`
+- **知识空间 ID：** `7612229802338045122`
+
+### 2. 全量反馈汇总多维表格（待上线）
+将三个数据源的反馈统一汇总到同一个飞书多维表格，支持分类、筛选、统计和跟进。
+
+## 支持功能
+
+| 功能 | 说明 |
+|------|------|
+| 主动上报记录 | 用户发 `用户反馈:` 开头消息自动记录到知识库 |
+| 多渠道查询 | 支持按时间、关键词、渠道、提交人查询所有反馈 |
+| 统计分析 | 按周/月统计反馈数量、类型、TOP问题 |
+| 定期汇总 | 自动生成反馈周报/月报，同步到知识库 |
+| 同步跟进 | 支持将反馈同步到任务管理系统，跟进解决进度 |
+
+## 主动上报执行流程（原有逻辑）
+
+### 1. 识别反馈内容
+
+从用户消息中提取 `用户反馈:` 或 `用户反馈：` 之后的文本作为反馈正文。去除前后空白。
+
+### 2. 总结梳理反馈内容
+
+对提取到的反馈正文进行智能总结和梳理：
+
+- 提炼核心观点，去除冗余表述
+- 保留关键事实、问题描述和诉求
+- 总结后的内容**不超过 300 字**
+- 如果原文本身不超过 300 字且条理清晰，可保持原文不变
+
+### 3. 获取提交人信息
+
+通过消息上下文中的 `sender_id`（open_id）调用 `feishu_get_user` 获取用户姓名。如获取失败，使用 open_id 作为标识。
+
+### 4. 追加写入文档
+
+使用 Bot 身份通过 lark-cli 将反馈追加到目标文档：
+
+```bash
+LARKSUITE_CLI_CONFIG_DIR=/root/.openclaw/credentials/xiaokui \
+  lark-cli docs +update --doc NVCRdIChwot7oPxcpopcBFMOned --as bot --mode append \
+  --markdown '<写入内容>'
+```
+
+### 5. 写入格式
+
+每条反馈按以下 Markdown 格式追加（使用分割线隔开每条反馈）：
+
+```markdown
+---
+
+**📅 时间：** YYYY-MM-DD HH:mm
+
+**👤 提交人：** <用户姓名>
+
+**� 反馈摘要：**
+
+<总结梳理后的内容，不超过300字>
+
+**💬 原始反馈：**
+
+<反馈原文>
+```
+
+- 时间使用 Asia/Shanghai 时区
+- 如果文档为空（首条反馈），先写入一级标题 `# 📋 用户反馈记录`，然后再追加反馈条目（不需要开头的分割线）
+
+### 6. 确认回复
+
+写入成功后，回复用户：「✅ 反馈已记录，感谢！」
+
+写入失败时，回复用户具体错误原因并建议重试。
+
+## 多渠道反馈查询流程
+
+### 查询飞书内部测试反馈
+1. 直接读取飞书表格 `E8vFsCmPBhT4SCtNmnJchqeJnJe` 数据
+2. 支持按时间范围、提交人、关键词筛选
+3. 每6小时自动同步最新群消息
+
+### 查询微信用户反馈
+1. 连接MySQL数据库 `vala_test`，查询 `wechat_group_message` 表
+2. 支持按时间范围、发送人、关键词、消息类型筛选
+3. 数据实时更新，可查询最新反馈
+
+## 注意事项
+
+- 所有文档/数据库操作默认使用只读权限，避免修改原始数据
+- 所有外部操作使用 Bot 身份（`--as bot`），不触发用户授权
+- 反馈正文会被总结梳理（不超过 300 字），同时保留原始反馈以供查阅
+- 任何人都可以提交反馈，无权限限制