---
name: edge-project-plan-writer
description: edge_collector 项目计划与实施拆分编写规范。用于为协议适配、云平台功能、边缘 agent、AI 分析、本地模型、前端页面、部署机制、故障治理等工作编写项目计划、里程碑、任务拆分、风险清单和验证排期。
---

# edge_collector 项目计划编写

## 适用场景

- 新协议适配计划。
- 云平台功能迭代计划。
- 边缘独立 agent 实施计划。
- AI 分析或本地模型接入计划。
- 前端复杂页面改造计划。
- 部署/打包/同步机制优化计划。
- 故障治理和稳定性专项计划。

## 推荐结构

```text
目标与范围
现状与约束
阶段划分
里程碑
任务拆分
依赖关系
验证计划
部署计划
风险与缓解
交付物
```

## 阶段模板

```text
阶段 1：调研与方案
阶段 2：最小可用实现
阶段 3：联调与异常场景
阶段 4：部署验证
阶段 5：文档与交付
```

按任务实际裁剪，不要机械套用。

## 任务拆分要求

每个任务写清：

- 目标。
- 涉及目录。
- 负责人或执行对象。
- 前置依赖。
- 验收标准。
- 验证命令或验证页面。

## 当前项目必须考虑

- 是否影响 `collector` 稳定性。
- 是否影响 `runtime/edge` 或 `runtime/cloud_server` 动态配置。
- 是否需要 82/97/94/87 或云服务器验证。
- 是否需要修改 `package.sh`、`deploy_cloud.sh`、`scripts/migrate_edge.sh`。
- 是否需要新增 systemd 服务或独立 agent。
- 是否需要用户文档和技术文档分开。

## 风险清单

常见风险：

- 跨架构第三方库不可用。
- 目标主机系统版本差异。
- 前端构建环境不一致。
- 配置同步覆盖运行态文件。
- AI Provider 超时、费用或响应格式差异。
- 真实设备不可用导致只能 mock 验证。

## 输出要求

- 计划要能直接转成执行清单。
- 不确定项标为“待确认”，不要伪装成已完成。
- 时间排期必须留出联调、回归和远程部署验证。