chore: sync before memory update

2026-05-01 12:04:12 +08:00
parent 1b3ae007ee
commit 0c46ed0306
22 changed files with 1850 additions and 20 deletions
@@ -0,0 +1,56 @@
+# 保存日报草稿（+draft）
+
+## 前置
+
+已通过 `report_get_tasks_to_report()` 获取待汇报任务列表。
+
+---
+
+## 草稿数据结构
+
+每个 `item` 包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `task_id` | string | 任务 ID（从待报任务中取） |
+| `content` | string | 汇报内容（今日进展） |
+| `progress` | int | 任务进度（0-100，整数） |
+| `status` | string | 可选，不改变则不传 |
+
+---
+
+## 执行步骤
+
+```
+Step 1: 展示待汇报任务列表，引导用户逐一填写内容
+
+        格式示例：
+        ┌─────────────────────────────────────────
+        │ 任务: [前端开发] 完成登录页面 UI 优化
+        │ 当前进度: 60%
+        │ 今日进展（请输入）: ___
+        │ 完成百分比（0-100）: ___
+        └─────────────────────────────────────────
+
+Step 2: 收集所有填写内容，构建 items 数组
+
+Step 3: [可选] 若用户请求 AI 辅助 → mcp__huanxi__llm_polish_report(content)
+        将润色建议展示给用户，由用户确认采用哪个版本
+
+Step 4: mcp__huanxi__report_save_draft(items=[
+          { task_id: "xxx", content: "...", progress: 80 },
+          ...
+        ])
+
+Step 5: 告知保存结果：
+        "已保存草稿，共 N 个任务条目。是否现在提交？"
+```
+
+---
+
+## 注意事项
+
+- `progress` 是 **整数百分比**（0-100），不是小数
+- 用户未填写 `content` 的任务：询问是否 dismiss（今天不汇报）还是暂时跳过
+- `report_save_draft` 是 upsert 操作，多次调用不会重复创建
+- 草稿保存成功后，下次调用 `report_get_today()` 可看到 draft 状态
@@ -0,0 +1,54 @@
+# 提交日报（+submit）
+
+## 前置条件
+
+- 草稿已通过 `report_save_draft()` 保存
+- 用户已查看并确认内容
+
+---
+
+## 执行步骤
+
+```
+Step 1: mcp__huanxi__report_get_today() → 获取最新草稿内容
+
+Step 2: 展示完整草稿给用户审阅：
+        ┌─────────────────────────────────────────
+        │ 📋 今日日报预览（2026-04-13）
+        │
+        │ ✅ 完成登录页面 UI 优化（进度 80%）
+        │    今日进展：完成了头部导航栏的响应式改造...
+        │
+        │ 🔄 接口联调（进度 50%）
+        │    今日进展：与后端对接了 3 个接口...
+        └─────────────────────────────────────────
+
+Step 3: 等待用户明确确认（"确认"/"提交"/"好的"/"ok"等）
+        ⚠️ 未收到确认前，禁止调用 report_submit
+
+Step 4: 对每个需提交的草稿条目（item.status == "draft"）：
+        mcp__huanxi__report_submit_item(item_id=<item.id>)
+        逐条提交，不影响其他条目状态
+
+Step 5: 告知提交结果：
+        "✅ 日报已提交！共 N 个任务条目。"
+```
+
+---
+
+## 提交失败处理
+
+| 错误 | 处理方式 |
+|------|---------|
+| 草稿为空 | 提示用户先填写内容（+draft） |
+| 已提交 | 告知已提交，询问是否撤回 |
+| 网络错误 | 告知用户，建议稍后重试 |
+
+---
+
+## 重要约束
+
+**禁止自动提交**：无论何种情况，`report_submit_item()` 调用前必须经过用户明确确认。
+这是强制规则，不得因为"用户已经填好了"或"工作流要求"而跳过确认步骤。
+
+**逐条提交，不做全量**：需先从 `report_get_today()` 获取各条目的 `item_id`，再逐条调用 `report_submit_item(item_id)`，不得批量提交所有条目（除非用户明确要求"全部提交"）。