feedback-loop

Files (14)

• SKILL.md
• _meta.json
• cli.js · bin/
• analysis.json · data/
• feedback.json · data/
• suggestions.json · data/
• package.json
• analyzer.js · src/
• collector.js · src/
• index.js · src/
• storage.js · src/
• suggester.js · src/
• tracker.js · src/
• run.js · test/

SKILL.md (first lines)

# Feedback Loop Skill

反馈循环器 - 一个完整的反馈收集、分析和改进跟踪系统，用于 OpenClaw 代理的持续优化。

## 功能概述

### 核心功能

1. **反馈收集（Feedback Collection）**
   - 显式反馈：用户主动评分、评论
   - 隐式反馈：从交互模式自动检测（完成、重试、放弃等）
   - 自动检测：基于会话模式智能识别反馈信号

2. **反馈分析（Feedback Analysis）**
   - 聚类分析：按类别、情感、评分分组
   - 趋势分析：时间序列趋势检测
   - 情感分析：正/负/中性情感分布
   - 模式检测：识别 recurring issues、行为模式等

3. **改进建议生成（Improvement Suggestions）**
   - 基于分析结果自动生成可执行的改进建议
   - 优先级排序（high/medium/low）
   - 包含具体 action items 和预期影响

4. **效果跟踪（Effect Tracking）**
   - 跟踪建议实施进度
   - 测量实施前后的影响
   - 生成综合报告

## 安装

```bash
# 通过 ClawHub 安装（推荐）
clawhub install feedback-loop

# 或手动安装
cd ~/.openclaw/workspace/skills/feedback-loop
npm install
npm link
```

## 使用方法

### CLI 命令

#### 1. 提供反馈（provide）

**显式反馈：**
```bash
feedback-loop provide --type explicit --rating 5 --comment "Excellent response!" --category accuracy
```

**隐式反馈：**
```bash
feedback-loop provide --type implicit --signal completion --sessionId sess123
feedback-loop provide --type implicit --signal retry --metrics '{"retryCount": 3}'
```

**参数说明：**
- `--type`: feedback 类型（explicit 或 implicit）
- `--rating`: 评分（1-5, thumbs_up, thumbs_down）
- `--comment`: 可选评论
- `--category`: 反馈类别（accuracy, speed, helpfulness 等）
- `--signal`: 隐式信号类型（completion, retry, abandon, correction 等）
- `--sessionId`: 会话标识符
- `--metrics`: JSON 格式的性能指标
- `--context`: JSON 格式的上下文信息

#### 2. 分析反馈（analyze）

```bash
# 分析最近一周的反馈
feedback-loop analyze --range week

# 只分析显式反馈
feedback-loop analyze --explicit-only

# 分析最近一个月的数据，输出 JSON
feedback-loop analyze --range month --output json
```

**参数说明：**
- `--range`: 时间范围（day, week, month, all）
- `--explicit-only`: 仅分析显式反馈
- `--output`: 输出格式（json, pretty）

#### 3. 生成建议（suggest）

```bash
# 生成最多 5 条建议
feedback-loop suggest --max 5

# 专注于特定类别
feedback-loop suggest --focus quality --max 10
```

**参数说明：**
- `--max`: 最大建议数量
- `--focus`: 专注的类别
- `--output`: 输出格式

#### 4. 跟踪进度（track）

```bash
# 跟踪建议实施进度
feedback-loop track fb_123456 --phase implementation --status in_progress

# 标记为已完成
feedback-loop track fb_123456 --phase deployed --status completed --notes "Successfully implemented"
```

**参数说明：**
- `--phase`: 实施阶段（planning, implementation, testing, deployed）
- `--status`: 状态（in_progress, completed, blocked）
- `--notes`: 附加说明
- `--metrics`: JSON 格式的进度指标

#### 5. 查看统计（stats）

From RenLimin/openclaw-workspace, MIT.

More from RenLimin/openclaw-workspace