Analyze User Feedback

Skill: analyze-user-feedback

类型: 规划期 Skill（planning/ 组） 调用时机: product-planning pipeline 第 1 节点；也可由 product-planning-agent 独立触发

---

用途

扫描 docs/feedback/ 目录下所有反馈原始文件，对用户反馈进行聚类、频次统计与优先级评分，输出结构化反馈洞察报告（对话内，不落盘），作为后续规划分析的输入数据。

---

前置条件

| 条件 | 说明 | |------|------| | 目录存在 | docs/feedback/ 存在（可为空，空则输出"暂无反馈数据"） | | 权限 | 只读 docs/feedback/** |

---

参数

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | topic | string | ✅ | 本次规划主题，用于过滤与主题相关的反馈 | | date_from | string | ❌ | 反馈起始日期（YYYY-MM-DD），默认过去 90 天 | | date_to | string | ❌ | 反馈截止日期，默认今天 |

---

执行步骤

Step 1 — 扫描反馈文件

读取 docs/feedback/ 目录所有文件（支持 .md / .yml / .txt）。若目录为空，在输出中注明并标记为 SKIPPED。

Step 2 — 聚类分析

将反馈按功能域/情感倾向聚类，输出：

• 高频词 TOP 10
• 功能模块投诉频次排名
• 正向反馈亮点（引用原文）
• 负向反馈痛点（引用原文）

Step 3 — 优先级评分

按以下维度对每类反馈打分（1-5）：

• 频次：提及次数占比
• 情感强度：用户情绪程度
• 战略相关度：是否命中规划主题 {{topic}}

Step 4 — 输出洞察报告

## 用户反馈洞察（{date_from} ~ {date_to}）

### 高优先级信号（Score ≥ 4）
| 反馈主题 | 频次 | 代表原文 | Score |
|---------|------|---------|-------|

### 中优先级信号（Score 2~3）
| 反馈主题 | 频次 | 代表原文 | Score |
|---------|------|---------|-------|

### 低优先级 / 正向反馈
- {亮点 1}
- {亮点 2}

### 结论摘要
{2-3 句规划建议}

---

错误处理

| 场景 | 处理 | |------|------| | docs/feedback/ 不存在 | 输出 SKIPPED，建议补充反馈数据源 | | 文件格式不可解析 | 跳过该文件，输出解析警告 | | topic 为空 | 使用 *（全量分析，不过滤主题） |

---

注意事项

1. 不落盘：本 Skill 只输出到对话上下文
2. 引用原文：洞察报告中的代表性原文需标注来源文件名
3. 跳过机制：若 pipeline 传入 skip_feedback=true，输出一行 SKIPPED（skip_feedback=true） 并立即返回

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xinyiai0724
• Source: xinyiai0724/tools
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.