复现已有算法

.claude/skills/edge-design-reviewer/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: edge-design-reviewer
+description: edge_collector 详细设计与方案评审规范。用于评审协议适配、云平台功能、边缘 agent、AI 分析、本地模型、前端页面、部署机制等设计文档，检查结构完整性、边界、接口、配置、数据流、前端可实现性、部署影响、测试和回滚。
+---
+
+# edge_collector 设计评审
+
+## 评审目标
+
+确认设计文档足够指导实现、测试和部署，不留下关键歧义。
+
+## 结论级别
+
+- `[严重]`：会导致无法实现、运行风险或数据/配置损坏。
+- `[警告]`：可实现但存在质量、可维护性或验证缺口。
+- `[建议]`：改进项，不阻塞。
+
+通过标准：无 `[严重]`，关键 `[警告]` 有明确处理计划。
+
+## 评审维度
+
+### 1. 文档结构
+
+- 背景、目标、范围、不做什么是否明确。
+- 是否有现状分析和约束。
+- 是否有实施步骤和验证计划。
+- 是否写清假设和待确认项。
+
+### 2. 云边职责
+
+- 边缘侧、云平台、前端、独立 agent 职责是否清晰。
+- 是否把高风险或长耗时任务放到合适进程。
+- 新增常驻进程是否独立，不耦合 `edge` 主服务。
+
+### 3. 接口与配置
+
+- API 路径、方法、请求、响应、错误码是否完整。
+- JSON 字段是否符合当前后端约定。
+- 配置文件路径、默认值、动态生成规则是否明确。
+- 是否会覆盖运行态动态配置。
+
+### 4. 数据流与状态流
+
+- 采集、缓存、上传、云端入库、展示、AI 分析链路是否完整。
+- 状态机是否覆盖成功、失败、超时、重试、停止。
+- 离线、断网、重启、服务异常是否有处理。
+
+### 5. 前端可实现性
+
+- 页面布局、主要状态、按钮反馈、错误提示是否明确。
+- 用户可见文案是否隐藏内部技术细节。
+- 权限、空状态、loading、长内容滚动是否覆盖。
+- 复杂页面是否需要原型或图示。
+
+### 6. 部署与运维
+
+- 是否影响 `package.sh`、`deploy_cloud.sh`、`scripts/migrate_edge.sh`。
+- 是否需要 `install_all.sh`，是否明确执行条件。
+- 是否需要 systemd 服务、日志路径、重启策略。
+- 是否考虑 82/97/94/87 和云服务器差异。
+
+### 7. 测试与回滚
+
+- 是否有单元、构建、接口、前端、设备或远程验证。
+- 是否覆盖异常场景。
+- 是否有回滚或降级策略。
+- 是否能验证“不覆盖运行配置”。
+
+## 输出格式
+
+```markdown
+## 评审结论
+
+通过 / 不通过 / 有条件通过
+
+## 问题列表
+
+| 级别 | 位置 | 问题 | 影响 | 建议 |
+|------|------|------|------|------|
+
+## 待确认项
+
+## 建议补充验证
+```
+
+## 注意
+
+- 评审先列问题，再写总结。
+- 文件和行号尽量具体。
+- 不把个人偏好当成缺陷。
+- 如果设计引用官方能力或第三方 SDK，拿不准时要联网查证。