cloud
109 lines
3.5 KiB
Markdown
109 lines
3.5 KiB
Markdown
---
|
|
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`。
|