---

name: rv1126-requirement-solution

description: 针对 RV1126 Linux 嵌入式平台，基于 research.md、object_top.md 及现有源码，生成新需求的完整技术方案。输出三类文档：技术方案文档(TSD)、评审报告文档(RRD)、实施任务文档(ITD)。方案满足大模型可执行、人类可评审、评审规则量化可见三大要求。当用户提出新需求、功能扩展、模块新增或架构变更时使用此技能。

---

# RV1126 新需求方案生成技能

## 快速开始

收到新需求时，依次执行以下 4 个步骤，生成三类文档。

---

## 步骤 0：读取项目基线（必须先执行）

按顺序读取以下文件，构建上下文：

```

1. RV1126/object_top.md      → 目标架构：18模块、MQTT主题、接口规范、重构原则P1~P7

2. RV1126/research.md        → 现有系统：单体架构、硬件接口、业务逻辑（分段读取前3000行）

3. 相关模块源码（按需）       → RV1126/source/<module>.cpp 或 RV1126/include/<module>.h

```

**关键约束（来自 object_top.md）**：

| 编号 | 原则 | 量化标准 |

|------|------|----------|

| P1 | 文件行数约束 | 每源文件 200~800 行，超 800 行必须拆分 |

| P2 | 进程独立性 | 每模块独占进程，独立编译运行测试 |

| P3 | 标准化接口 | 每进程含 CLI 参数解析、stdout JSON、退出码 0~5 |

| P4 | MQTT 消息总线 | 进程间通信只走 mosquitto localhost:1883 |

| P5 | 零共享状态 | 进程间不共享内存/文件句柄 |

| P6 | 可观测性 | 必须发布 `status/<module>/heartbeat` 和 `/error` |

| P7 | 优雅退出 | 监听 `sys/shutdown` 和 SIGTERM |

---

## 步骤 1：需求分析（输出结构化摘要）

分析用户需求，识别：

- **需求类型**：新模块 / 现有模块扩展 / 跨模块流程 / 硬件接口变更

- **影响范围**：列出受影响的模块名（来自 object_top.md 的 18 个模块）

- **涉及 MQTT 主题**：新增/修改的主题（遵循 `<domain>/<module>/<action>` 命名）

- **硬件约束**：串口、GPIO、I2C、SPI 等冲突点

- **与现有代码的映射**：对应 research.md 中的哪些函数/类

---

## 步骤 2：生成三类文档

### 文档一：技术方案文档 (TSD)

详见 [TSD-template.md](TSD-template.md)

**必填章节**：

1. 需求概述与背景

2. 方案设计（架构图、模块职责、接口定义）

3. MQTT 主题清单（表格：主题、QoS、Payload格式、发布者、订阅者）

4. 源文件拆分规划（表格：文件名、职责、预估行数）

5. CLI 接口定义（所有 `--参数` 列表）

6. 与现有模块的集成点

### 文档二：评审报告文档 (RRD)

详见 [RRD-template.md](RRD-template.md)

基于量化评审规则（见 [REVIEW-RULES.md](REVIEW-RULES.md)）逐项打分，输出：

- 每条规则：**符合 ✅ / 不符合 ❌ / 部分符合 ⚠️** + 具体说明

- **量化得分**：已符合条目数 / 总条目数（如 18/22）

- **必须修复项**（❌ 项清单）

- **评审结论**：通过 / 条件通过 / 不通过

### 文档三：实施任务文档 (ITD)

详见 [ITD-template.md](ITD-template.md)

AI 可直接执行的分解任务列表：

- 每个任务含：任务编号、操作类型（创建文件/修改文件/添加MQTT订阅）、精确的目标文件路径、完整的代码骨架或伪代码

- 任务按依赖顺序排列，可逐条执行

- 包含验证命令（编译检查、MQTT消息测试）

---

## 步骤 3：自动评审

生成三类文档后，立即用 REVIEW-RULES.md 中的规则对 TSD 进行评审，输出 RRD 得分。若得分 < 80%（即不足 18/22），标记不通过并列出修复项。

---

## 附加资源

- 评审量化规则：[REVIEW-RULES.md](REVIEW-RULES.md)

- TSD 模板：[TSD-template.md](TSD-template.md)

- RRD 模板：[RRD-template.md](RRD-template.md)

- ITD 模板：[ITD-template.md](ITD-template.md)