cloud
3.5 KiB
3.5 KiB
name, description
| name | description |
|---|---|
| edge-user-story-reviewer | 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 和打印预览。
- 前端交互型故事的图是否贴近当前暗色前端风格。
输出格式
## 评审结论
通过 / 有条件通过 / 不通过
## 问题列表
| 级别 | 位置 | 问题 | 影响 | 建议 |
|------|------|------|------|------|
## 拆分建议
## 需要补充的验收标准
## 业务场景图检查
## 风险与待确认
严重问题示例
- 没有验收标准。
- 验收标准无法验证。
- 没有写不包含范围，导致明显范围膨胀。
- 涉及部署同步但未说明运行配置保护。
- 涉及 AI Key、密码、Token 却没有安全边界。
- 协议适配没有真实设备或 mock 验证方案。
- 复杂用户故事缺少业务场景 SVG，导致流程和边界无法直观看清。
与其他 skill 协作
- 发现需求不清：转
edge-requirement-interview。 - 发现规则未沉淀：转
edge-business-rule-extractor。 - 发现故事过大：建议拆分后再进入
edge-design-doc-writer。