Proposal：执行反馈

[yyy-router]

Issue：Feedback 模块

1. 功能描述

Feedback 模块记录 Schedule、Todo、Task 的执行事实。用户可以通过 AI 自然语言或页面表单提交反馈，系统确认后原子更新对象状态和 Feedback 记录。

Feedback 是重排和即时复盘的重要事实来源。

2. 用户 / 用户故事

目标用户：需要记录事项真实完成状态、耗时和偏差原因，以便后续重排和复盘的个人用户。

• 用户说“刚才那个任务完成了，实际用了 90 分钟”。
• 用户说“今天晚上的任务没做，因为临时开会”。
• 用户在日程 Tab 点击事项并填写完成状态、实际耗时和原因。

3. 现有做法及不足

如果没有统一的反馈模块，Schedule、Todo、Task 的执行事实会分散在不同入口里，后续重排和复盘也难以共用同一份事实来源。

反馈模块只负责对象定位、结构化反馈候选和确认后写入，最终写入由主 Agent 执行。

4. 本期范围

1. 支持 Schedule / Todo / Task 的统一 Feedback。
2. 支持 AI 自然语言 Feedback。
3. 支持表单 Feedback。
4. Feedback Agent 在主 Agent 提供候选事实后定位对象。
5. Feedback Agent 生成结构化反馈候选。
6. 用户确认后，状态和 Feedback 原子写入。
7. Feedback 可触发被动重排判断。
8. Schedule / Task 结束后可生成 FeedbackEntry 并注册入口提醒；FeedbackEntry 只描述待反馈对象和入口状态，不是 Feedback 事实。

5. 明确不做

• 不做自动无确认反馈。
• 不做子 Agent 直接写 Feedback。
• 不做无限字段的复杂复盘问卷。
• 不强制普通 Todo 提交完整反馈。
• 不把 Feedback 写入后立即触发复盘生成。
• 不把 FeedbackEntry 或反馈提醒视为用户已经提交 Feedback。

6. 关键决策

决策点	备选方案	选择	理由
反馈对象	各对象独立模型 / 三类对象统一	Schedule / Todo / Task 统一	为重排和复盘提供同源事实
入口	仅 AI / 仅表单 / 两者	AI + 表单	兼顾低摩擦和确定性
写入	状态和反馈分开 / 原子写入	状态 + Feedback 原子写入	防止状态与事实不一致
对象不唯一	LLM 猜测 / 要求选择	要求选择	不能猜测落库
触发重排	每次调用 Agent / 规则判断	规则判断	不是每次反馈都调用重排 Agent

7. 边界与异常

• 反馈对象不唯一时，主 Agent 要求用户选择。
• 反馈对象不存在或已删除时，不落库。
• 状态更新成功但 Feedback 写入失败时必须回滚。
• 用户只说“完成了”且上下文无法定位对象时，需要追问。
• Feedback 写入后只触发重排判断，不自动应用重排。

8. 基本概念与信息结构

概念	含义
Feedback	某个事项的一次执行事实
FeedbackEntry	Schedule / Task 结束后的反馈入口意图和对象配置，不是执行事实
target_type	schedule / todo / task
target_id	目标对象 ID
status_change	需要原子应用的状态变化
actual_duration	可选实际耗时
reason	未完成、延期或偏差原因
note	用户补充说明

9. Agent 输入输出约束

• 主 Agent 读取候选时间范围内的 Schedule / Todo / Task。
• Feedback Agent 在给定候选中定位对象并生成结构化反馈。
• Feedback Agent 不直接读写数据库。
• 涉及写入时返回 isNeedUser = true 和 db_action。
• 主 Agent 在确认后完成原子写入。
• FeedbackEntry 由确定性规则产生，点击后只打开对象明确的反馈入口；用户提交并确认后才产生 Feedback。

10. 验收标准

• 用户可对 Schedule / Todo / Task 提交 Feedback。
• AI 自然语言反馈能在候选对象中定位目标。
• 对象不唯一时要求用户选择。
• 用户确认后状态和 Feedback 同时写入。
• 任一写入失败时不出现半成功。
• Feedback 写入后可被重排和即时复盘读取。
• Schedule / Task 结束后可产生 Feedback 入口提醒，但未提交前数据库中不存在对应 Feedback 事实。