---
name: edge-user-story-reviewer
description: edge_collector 用户故事评审规范。用于审查协议适配、边缘功能、云平台功能、AI 分析、本地模型、前端页面、部署运维等用户故事是否清晰、可测、范围合适、验收标准完整，并识别拆分建议和风险。
---

# edge_collector 用户故事评审

## 目标

确认用户故事能进入方案设计或实现阶段，避免范围不清、验收不可测、实现边界混乱。

## 评审结论

- 通过：可进入设计或实现。
- 有条件通过：小问题已列出，可同步修正。
- 不通过：存在严重范围、验收或安全风险。

## 检查维度

### 1. 价值清晰

- 是否写清角色、动作、价值。
- 是否能说明“不做有什么影响”。
- 是否避免只写“实现某接口/改某文件”。

### 2. 范围合适

- 一个故事是否只交付一个清晰能力。
- 是否混入多个独立功能。
- 是否写清不包含范围。
- 是否能在一次迭代中完成验证。

### 3. 验收可测

- 每个验收场景是否有 Given/When/Then 或等价描述。
- 是否覆盖正常路径、异常路径、边界条件。
- 是否写明验证方式。
- 是否能通过页面、接口、日志、构建、远程主机或设备验证。

### 4. 项目约束

- 是否会覆盖运行时动态配置。
- 是否需要 `install_all.sh`，是否明确触发条件。
- 是否涉及 82/97/94/87 或云服务器验证。
- 是否需要新增 systemd 服务或独立 agent。
- 是否影响 `collector` 稳定性。

### 5. 用户可见信息

- 是否泄露 helper、SDK、库路径、AI Provider、模型内部配置、密钥。
- 用户文案是否面向现场用户或运维人员。
- 错误提示是否可理解。

### 6. 拆分建议

遇到以下情况建议拆分：

- 一个故事包含 4 个以上主要验收场景。
- 同时改边缘、云端、前端、部署且无法独立验证。
- 同时包含功能开发和大规模重构。
- 同时包含用户功能和运维自动化。
- 协议适配同时覆盖多个设备族或多个 SDK 运行方式。

### 7. 业务场景图

- 复杂流程、云边链路、协议采集链路、部署流程、AI 分析数据流、前端多区域交互是否提供 SVG。
- SVG 是否放在用户故事文档旁边的 `assets/` 并被 Markdown 正文引用。
- 图中是否只表达用户、业务对象、流程、状态和结果。
- 是否泄露 helper、SDK、库路径、AI Key、内部模型配置、接口路径或调试信息。
- 文档/方案型故事的图是否适合 Markdown 和打印预览。
- 前端交互型故事的图是否贴近当前暗色前端风格。

## 输出格式

```markdown
## 评审结论

通过 / 有条件通过 / 不通过

## 问题列表

| 级别 | 位置 | 问题 | 影响 | 建议 |
|------|------|------|------|------|

## 拆分建议

## 需要补充的验收标准

## 业务场景图检查

## 风险与待确认
```

## 严重问题示例

- 没有验收标准。
- 验收标准无法验证。
- 没有写不包含范围，导致明显范围膨胀。
- 涉及部署同步但未说明运行配置保护。
- 涉及 AI Key、密码、Token 却没有安全边界。
- 协议适配没有真实设备或 mock 验证方案。
- 复杂用户故事缺少业务场景 SVG，导致流程和边界无法直观看清。

## 与其他 skill 协作

- 发现需求不清：转 `edge-requirement-interview`。
- 发现规则未沉淀：转 `edge-business-rule-extractor`。
- 发现故事过大：建议拆分后再进入 `edge-design-doc-writer`。