# 多入口功能同步规范（Hua.Todo 专属）

> 适用范围：本规则属于 **项目规则**（仅 Hua.Todo 项目生效）。

---

## 一、背景

Hua.Todo 存在两个功能入口：

| 入口 | 位置 | 方式 |
|---|---|---|
| **UI 入口** | WebView / 前端界面（Hua.Todo.Web） | 键盘/鼠标/触控交互 |
| **语音控制入口** | 语音指令（平台原生 STT + LLM 意图解析） | 语音输入 → 指令执行 |

v1.3.0 之前，功能开发只关注 UI 入口。v1.3.0 工单 02 落地后语音控制入口正式就绪，此后**所有新增功能必须在需求阶段同步确认两个入口的覆盖情况**。

---

## 二、核心规则

### 2.1 功能入口检查（强制）

每次新增功能（含新工单、新特性），智能体必须在需求讨论或工单拆分阶段执行以下检查：

| 检查项 | 说明 |
|---|---|
| **UI 入口** | 当前功能是否已有 UI 入口规划？入口在哪个页面/组件？交互方式是什么？ |
| **语音控制入口** | 当前功能是否已有语音指令规划？对应哪个意图？参数是什么？LLM prompt 是否需要更新？ |

### 2.2 缺失时为通知用户，不自行决策

- 任一入口缺失时，**智能体必须主动告知用户**，由用户决定：
  1. 本次就做（补上缺失入口）
  2. 本次不做（记录为已知缺口，后续版本补）
  3. 不需要（该入口不适合此功能，如选项过多需可视化交互的操作）
- **智能体不得在用户未确认的情况下自行跳过或自行补充入口设计**

### 2.3 输出格式（检查表）

智能体在需求讨论阶段，必须输出以下检查表：

```markdown
## 功能入口覆盖检查

| 入口 | 已规划 | 方案 |
|---|---|---|
| UI | ✅ / ❌ | [描述 UI 入口] |
| 语音 | ✅ / ❌ | [描述语音指令与意图] |

> 不可覆盖的入口说明：[如"语音控制暂不支持 XX 操作（原因）"]
```

---

## 三、适用场景

### 3.1 必须检查的场景

- 新增业务功能（如新增双因素认证、新增标签系统）
- 新增 API 端点（如新增导出/导入）
- 新增 UI 页面/组件（如新增设置页、新增弹窗）
- 新工单拆分阶段

### 3.2 无需检查的场景

- 纯 bug 修复
- 纯性能优化（不改变用户可感知功能）
- 纯基础设施调整（如 CI/CD、打包脚本）
- 依赖升级

---

## 四、检查清单

1. [ ] 本次新增功能是否已确认 UI 入口？
2. [ ] 本次新增功能是否已确认语音控制入口？
3. [ ] 缺失入口是否已通知用户并记录决策？
4. [ ] LLM intent parser 的 prompt 是否需要同步更新（新增意图/新增参数）？

---

## 五、与工单 02 的关系

本规范的语音入口覆盖检查表来源于 [docs/project/研发工单-v1.3.0/02-语音通话与语音控制.md](../../../docs/project/研发工单-v1.3.0/02-语音通话与语音控制.md) 的第七章"与其他工单的语音入口衔接"。