ShaoHua
9223ceca50
- 规则重组：全局/ 下 8 个规则合并为 6 个（01+02→01，05+06→04），序号顺延 - 新增项目规则 05-多入口功能同步规范（UI/语音入口覆盖检查） - 新增 MCP 服务基础设施：Mcp/ 目录（DI 注册、端点扩展、动态工具描述符）、单元测试 - v1.3.0 工单文档：03 系列（会议任务拆分）、04（富文本描述与附件管理） - MCP 接口与前端集成指南：docs/manual/08、09
86 lines
2.9 KiB
Markdown
86 lines
2.9 KiB
Markdown
# 多入口功能同步规范（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) 的第七章"与其他工单的语音入口衔接"。
|