| name | bfd-user-feedback |
| description | 用户反馈与状态监控技能。触发：(1)用户反馈收集请求 (2)运行状态监控 (3)错误日志记录 (4)关键词"收集反馈"、"用户反馈"、"状态监控"、"交互反馈" (5)任务完成需用户确认。禁止跳过用户确认、禁止忽略用户反馈。 |
BFD User Feedback
Self-Improvement Loop (Required)
- When this skill encounters a build, flash, debug, script-usage, or other workflow problem, do not stop at the local workaround after the issue is solved.
- Record the resolved issue and lesson in
BFD-Kit/.learnings/ERRORS.md and/or BFD-Kit/.learnings/LEARNINGS.md; unresolved capability gaps go to BFD-Kit/.learnings/FEATURE_REQUESTS.md.
- Promote reusable fixes into the affected BFD-Kit asset in the same task when feasible: update the relevant
SKILL.md, script, wrapper, or resource so the next run benefits by default.
- When a learning is promoted into a skill or script, append a short entry to
BFD-Kit/.learnings/CHANGELOG.md and mention the improvement in the task close-out.
触发条件
- 用户请求收集反馈
- 需要监控运行状态
- 错误日志记录请求
- 关键词：收集反馈、用户反馈、状态监控、交互反馈
- 任务完成需用户确认
调用形式
完整调用
请使用 bfd-user-feedback 技能收集用户反馈
简写调用
收集用户反馈
状态监控
交互反馈
用户反馈收集接口
MCP 工具调用
使用 mcp-feedback-enhanced MCP 工具进行用户反馈收集：
mcp_feedback_enhanced(
title="STM32 项目反馈",
summary="当前任务执行摘要",
status="waiting_feedback"
)
反馈收集时机
| 场景 | 触发条件 | 反馈类型 |
|---|
| 任务完成 | 代码修改完成 | 确认反馈 |
| 错误发生 | 编译/运行错误 | 错误反馈 |
| 状态变更 | 重要状态变化 | 状态反馈 |
| 用户请求 | 用户主动请求 | 自由反馈 |
运行状态监控
状态类型
class ProjectStatus:
IDLE = "idle"
BUILDING = "building"
DEBUGGING = "debugging"
FLASHING = "flashing"
ERROR = "error"
WAITING_FEEDBACK = "waiting"
状态监控流程
- 状态检测：检测当前项目运行状态
- 状态记录：记录状态变更信息
- 状态通知：向用户报告状态变化
- 异常处理：处理异常状态转换
错误日志记录
调用 build-error-logger 技能
当检测到错误时，调用 build-error-logger 技能记录错误：
请使用 build-error-logger 技能记录当前构建错误
错误记录触发条件
反馈数据格式
标准反馈格式
{
"timestamp": "2026-02-21T10:30:00Z",
"feedback_type": "user_confirmation",
"project_status": "building",
"summary": "任务执行摘要",
"details": {
"action_taken": "代码修改",
"files_modified": ["main.c", "config.h"],
"result": "成功"
},
"user_response": null
}
反馈类型定义
| 类型 | 说明 | 用途 |
|---|
user_confirmation | 用户确认 | 任务完成确认 |
error_report | 错误报告 | 错误信息收集 |
status_update | 状态更新 | 进度通知 |
user_request | 用户请求 | 用户主动请求 |
工作流程
标准反馈收集流程
1. 检测触发条件
↓
2. 收集当前状态信息
↓
3. 生成反馈摘要
↓
4. 调用 mcp-feedback-enhanced 工具
↓
5. 等待用户反馈
↓
6. 处理用户反馈
↓
7. 执行后续操作（如有）
错误处理流程
1. 检测错误
↓
2. 记录错误信息
↓
3. 调用 build-error-logger 技能
↓
4. 收集用户反馈
↓
5. 根据反馈执行操作
禁止内容清单
严格禁止：
- 跳过用户确认步骤
- 忽略用户反馈内容
- 自行决定任务完成
- 隐瞒错误信息
必须执行：
- 每次任务完成收集用户反馈
- 如实报告所有状态
- 正确记录错误信息
- 尊重用户决策
目录结构
.trae/skills/bfd-user-feedback/
├── SKILL.md
├── scripts/
│ ├── feedback_collector.py
│ └── status_monitor.py
└── references/
└── user-feedback-reference.md
相关技能
- build-error-logger: 构建错误日志记录
- mcp-feedback-enhanced: MCP 反馈工具
参考文档
详细反馈格式和示例请参考 user-feedback-reference.md。
