Version: 0.5.8.dev.260315

♻️ refactor(agent): 拆分 agentsvc，并增强 quicknote/outbox 注释与可维护性

- 📦 将 Agent 服务实现从 `service` 根目录迁移到 `service/agentsvc`，包含 `agent.go`、`agent_quick_note.go` 及相关测试
- 🔌 新增 service 层兼容桥接 `agent_bridge.go`，保持 `service.NewAgentService` 与 `*service.AgentService` 现有调用方式不变
- 📝 为 `quicknote` 补充高密度中文步骤化注释，覆盖 `graph` / `runner` / `nodes` / `tool` / `state` / `prompt`，明确职责边界、分支条件、重试与兜底策略
- 🧭 为 `infra/outbox` 与 service agent 链路补充详细中文注释，覆盖状态机流转、幂等处理、失败回写与异步持久化语义
- ✅ 统一格式化相关文件，并通过全量后端测试：`go test ./...`

📝 chore(docs): 更新 AGENTS.md 注释强制规范

- 📚 追加“注释规范（强制）”与“注释风格示例”
- ✍️ 明确复杂逻辑必须使用步骤化注释、跨文件调用需写调用目的、注释需同步维护

backend/agent/quicknote/prompt.go

@@ -5,6 +5,10 @@ const (
 	// - 仅负责判断用户输入应走 quick_note 还是 chat；
 	// - 不直接回答用户问题；
 	// - 必须输出可机读控制码，便于后端无歧义解析。
+	// 额外说明：
+	// 1) 这里要求固定 XML 结构，是为了让后端做严格字符串/标签解析，而不是模糊关键词匹配；
+	// 2) 增加 reason 标签，主要用于日志排障（看模型为何判到 quick_note/chat）；
+	// 3) 明确“禁止输出其他内容”，是为了减少模型附加寒暄导致解析失败。
 	QuickNoteRouteControlPrompt = `你是 SmartFlow 的请求分流控制器。
 你的唯一任务是给后端返回可机读控制码，不要做用户可见回复，不要解释。
 
@@ -22,6 +26,10 @@ const (
 	// QuickNotePlanPrompt 用于“单请求聚合规划”：
 	// - 在一次调用内完成标题抽取、时间归一化、优先级评估、跟进句生成；
 	// - 主要用于路由已明确命中 quick_note 的场景，以降低串行 LLM 调用次数。
+	// 额外说明：
+	// 1) 强制 JSON 输出，减少后端解析分支复杂度；
+	// 2) deadline_at 统一分钟级，方便直接映射到数据库时间字段；
+	// 3) banter 与事实分离，避免润色文案污染结构化字段。
 	QuickNotePlanPrompt = `你是 SmartFlow 的任务聚合规划器。
 你将基于用户输入，一次性输出任务规划结果，供后端直接写库。
 
@@ -42,6 +50,7 @@ const (
 	// 1) 只做识别与抽取，不允许模型宣称“已写库”；
 	// 2) 遇到相对时间必须先换算成绝对时间，减少后续工具层歧义；
 	// 3) 若无时间信息必须返回空字符串，避免幻觉时间污染数据库。
+	// 4) 把“当前时间”明确注入 prompt，保证相对时间换算有统一基准。
 	QuickNoteIntentPrompt = `你是 SmartFlow 的“随口记分诊器”。
 请判断用户输入是否表达了“帮我记一个任务/日程”的需求。
 - 若是，请提取任务标题与时间线索。
@@ -51,6 +60,7 @@ const (
 
 	// QuickNotePriorityPrompt 用于第二阶段：将任务归类到四象限优先级。
 	// 输出会直接映射到 tasks.priority（1~4），因此要求结果必须可解释。
+	// 这里强调“理由必须可解释”，是为了后续日志复盘时能看懂模型为何这么判。
 	QuickNotePriorityPrompt = `你是 SmartFlow 的任务优先级评估器。
 根据任务内容、时间约束和执行成本，输出优先级 priority_group：
 1=重要且紧急，2=重要不紧急，3=简单不重要，4=不简单不重要。