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
2.9 KiB
2.9 KiB
多入口功能同步规范（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 缺失时为通知用户，不自行决策
- 任一入口缺失时，智能体必须主动告知用户，由用户决定：
- 本次就做（补上缺失入口）
- 本次不做（记录为已知缺口，后续版本补）
- 不需要（该入口不适合此功能，如选项过多需可视化交互的操作）
- 智能体不得在用户未确认的情况下自行跳过或自行补充入口设计
2.3 输出格式（检查表）
智能体在需求讨论阶段，必须输出以下检查表：
## 功能入口覆盖检查
| 入口 | 已规划 | 方案 |
|---|---|---|
| UI | ✅ / ❌ | [描述 UI 入口] |
| 语音 | ✅ / ❌ | [描述语音指令与意图] |
> 不可覆盖的入口说明：[如"语音控制暂不支持 XX 操作（原因）"]
三、适用场景
3.1 必须检查的场景
- 新增业务功能（如新增双因素认证、新增标签系统）
- 新增 API 端点（如新增导出/导入）
- 新增 UI 页面/组件（如新增设置页、新增弹窗）
- 新工单拆分阶段
3.2 无需检查的场景
- 纯 bug 修复
- 纯性能优化（不改变用户可感知功能）
- 纯基础设施调整（如 CI/CD、打包脚本）
- 依赖升级
四、检查清单
- 本次新增功能是否已确认 UI 入口？
- 本次新增功能是否已确认语音控制入口？
- 缺失入口是否已通知用户并记录决策？
- LLM intent parser 的 prompt 是否需要同步更新（新增意图/新增参数）？
五、与工单 02 的关系
本规范的语音入口覆盖检查表来源于 docs/project/研发工单-v1.3.0/02-语音通话与语音控制.md 的第七章"与其他工单的语音入口衔接"。