wind_power_cal/.agents/skills/edge-bug-lessons/SKILL.md

name, description

name	description
edge-bug-lessons	edge_collector Bug 经验库沉淀规范。用于用户要求 bug 教训、故障复盘、为什么流出、总结经验、沉淀规则时，把边缘侧、云平台、协议采集、部署同步、前端、AI、网络等问题整理为可检索的历史 lesson 和预防规则。

edge_collector Bug 经验库

目标

把一次故障从“修好了”沉淀为“以后能提前拦住”。重点记录根因链路、漏检点、验证方式和反哺动作。

触发场景

• “总结这次 bug”
• “为什么会流出”
• “写一个复盘”
• “沉淀经验”
• “以后怎么避免”
• 修复完成后需要补长期规则

默认落点

docs/bugfix/BugLesson-YYYYMMDD-简述.md
docs/bugfix/BugLesson-index.md

如果已有更合适的专题目录，可放到：

• docs/鲁班猫*/
• collector/docs/protocols/
• docs/ops/

但索引仍建议保留在 docs/bugfix/BugLesson-index.md。

Lesson 结构

# 标题

**日期**:
**模块**:
**影响范围**:

## 1. 问题现象

## 2. 根因链路

## 3. 流出路径 / 漏检点

## 4. 修复内容

## 5. 验证结果

## 6. 本可在哪一步拦住

## 7. 预防措施

## 8. 可复用规则

## 9. 反哺动作

## 10. 相关文件

当前项目重点

优先沉淀以下类型：

• 打包或同步覆盖运行态动态配置。
• 97/94/82 等主机系统差异导致运行异常。
• FANUC/西门子协议库、架构、链接方式问题。
• 前端白屏、按钮无反馈、错误提示过泛。
• AI 分析超时、空内容、内部配置泄露。
• WiFi/4G/frpc/端口转发独立 agent 异常。
• 云端设备在线状态、历史趋势、数据不连续误判。

写法要求

• 区分“已确认事实”和“推断”。
• 根因必须落到文件、配置、命令、日志或环境差异。
• 不写“加强测试”这类空话，要写可执行拦截点。
• 反哺动作要明确更新哪个 skill、测试清单、文档或脚本检查项。
• 涉及密钥、密码、Token 时必须脱敏。

索引格式

| 日期 | 标题 | 模块 | 核心根因 | 漏检点 | 预防规则 | 文件 |
|------|------|------|----------|--------|----------|------|