# Analyze User Feedback

> 读取 docs/feedback/ 下的用户反馈原始数据，进行聚类分析、优先级归因，输出结构化反馈洞察报告到对话上下文，供 product-planning pipeline 调用。

- **Type:** Skill
- **Install:** `agentstack add skill-xinyiai0724-tools-analyze-user-feedback`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xinyiai0724](https://agentstack.voostack.com/s/xinyiai0724)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** https://github.com/xinyiai0724/tools/tree/main/skills/planning/analyze-user-feedback

## Install

```sh
agentstack add skill-xinyiai0724-tools-analyze-user-feedback
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 — 输出洞察报告

```markdown
## 用户反馈洞察（{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](https://github.com/xinyiai0724)
- **Source:** [xinyiai0724/tools](https://github.com/xinyiai0724/tools)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xinyiai0724-tools-analyze-user-feedback
- Seller: https://agentstack.voostack.com/s/xinyiai0724
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.