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,97 @@
+# 周报草稿（+draft，仅限模块负责人）
+
+## 数据来源
+
+周报草稿基于**本周负责人日报汇总**（`leader_report_get_batch` 返回值），而非员工个人日报。
+
+| 数据 | 来源 | 说明 |
+|------|------|------|
+| 本周每日负责人日报 | `leader_report_get_batch(date列表, module_ids)` | 含各日的模块进展 + 下属提交情况摘要 |
+| 现有周报草稿 | `weekly_report_get_batch(year, week, module_ids)` | 已填写的草稿（若有） |
+
+---
+
+## 草稿生成步骤
+
+```
+Step 1: 解析本周负责人日报数据
+        → 按日期排列，提取每日：
+          · 模块整体进展
+          · 团队成员提交情况
+          · 遇到的问题与风险
+
+Step 2: AI 基于负责人日报起草 content（本周总结）：
+        - 提炼本周模块核心进展（任务推进 + 里程碑）
+        - 汇总团队整体情况
+        - 列出本周识别的问题与应对
+
+Step 3: AI 起草 next_week_plan（下周计划）：
+        - 基于本周未完成项和下周目标
+        - 结合用户补充的计划
+
+Step 4: 展示草稿给用户审阅修改
+
+Step 5: 用户确认后逐模块保存：
+        mcp__huanxi__weekly_report_save(
+          module_id      = "<模块ID>",
+          year           = <ISO year>,   ← 注意：ISO year，不是日历年
+          week           = <ISO week>,
+          content        = "<本周总结>",
+          next_week_plan = "<下周计划>"
+        )
+```
+
+---
+
+## 内容格式建议（负责人视角）
+
+**content（本周总结）：**
+```markdown
+## 本周模块进展
+
+- **[任务A]** 完成 XX 功能开发，进度推进至 80%（负责人：张三）
+- **[任务B]** 完成接口联调，已提测（负责人：李四）
+
+## 团队提交情况
+
+本周全员提交日报，无缺报。
+
+## 问题与风险
+
+- [周三] 第三方接口超时问题，已升级厂商处理，预计周一恢复
+
+## 本周总体评估
+
+整体按计划推进，无阻塞性风险。
+```
+
+**next_week_plan（下周计划）：**
+```markdown
+- [任务A] 目标完成剩余 20% 并提测
+- [任务B] 协助测试团队完成验收
+- 启动 [新需求] 的技术调研
+```
+
+---
+
+## 已有草稿处理
+
+若 `weekly_report_get_batch()` 中该模块已有草稿（非 empty）：
+- 展示现有草稿内容
+- 询问："是在此基础上修改，还是基于本周负责人日报重新生成？"
+- 基于用户选择执行对应操作
+
+---
+
+## 多模块处理
+
+```
+for module in leader_modules:
+  1. 提取该模块的 leader_report_batch（本周各日记录）
+  2. AI 生成草稿（content + next_week_plan）
+  3. 展示给用户确认/修改
+  4. weekly_report_save(module_id=module.id, year, week, ...)
+  5. 告知：模块 "{module.name}" 草稿已保存 ✅
+
+所有模块草稿完成后：统一展示，询问是否提交
+```