---
name: huanxi-weekly
description: "寰汐周报工作流（仅限模块负责人）：查看本周周报状态（+check）、基于本周负责人日报 AI 汇总草稿（+draft）、提交周报（+submit）、撤回（+withdraw）。当用户说"写周报"、"提交周报"、"本周总结"、"周报进度"时触发。"
---

# 寰汐周报（仅限模块负责人）

**前置条件：先 Read `../huanxi-shared/SKILL.md`（缓存规则 + TTL 策略）**

---

## 权限说明

**周报只有模块负责人（`my_role == 'leader'`）才需要提交。**

若用户不是任何模块的负责人：
- 告知："您目前不是任何模块的负责人，无需提交周报。"
- 建议：若有疑问，可联系管理员确认模块角色。

---

## ISO 周数规范（重要）

寰汐周报使用 **ISO 8601 标准**：
- `year` 字段存 **ISO year**（不是日历年）
- 12月底/1月初可能跨年：如 2025-12-29 的 ISO year = 2026（第1周）
- Python 获取：`date.isocalendar()` → `(iso_year, week, weekday)`

**当前日期 → ISO 周号计算示例：**
- 2026-04-13（周一）→ year=2026, week=16

---

## 标准工作流

```
Step 0: 确认负责人身份和模块
  → Read ~/.claude/huanxi-cache/modules.json（24h 缓存）
  → 若过期：mcp__huanxi__module_list() → 更新缓存
  → 筛选 my_role == 'leader' 的模块列表
  → 若列表为空：告知用户无需提交周报，流程终止
  → 若有多个 leader 模块：询问"要提交哪些模块的周报？"

Step 1: 确定当前 ISO 周号
  → 根据今日日期计算 (iso_year, iso_week)
  → 告知：第 iso_week 周（周一 ~ 周日 日期范围）

Step 2: 批量拉取周报草稿
  → mcp__huanxi__weekly_report_get_batch(
      year=iso_year,
      week=iso_week,
      module_ids=[<leader 模块的 ID 列表>]
    )
  → 返回：各模块的现有草稿状态

Step 3: 逐日拉取本周负责人日报
  → 计算本周日期范围（周一到今日，YYYY-MM-DD 格式列表）
  → 对每个日期逐一调用：
      mcp__huanxi__leader_report_get_batch(
          date=<单个日期>,
          module_ids=[<leader 模块的 ID 列表>]
      )
  → 汇总所有日期的返回数据
  → 展示：本周每日负责人日报记录（含各日进展摘要 + 下属提交情况）

Step 4: 询问是否 AI 汇总
  → 展示本周负责人日报数据后，询问：
    "是否需要 AI 根据本周负责人日报自动生成周报草稿？"
  → 用户同意 → AI 基于 leader_report_batch 起草：
               · content：本周模块整体进展总结
               · next_week_plan：下周模块工作计划
               → 展示草稿，供用户审阅和修改
  → 用户拒绝 → 引导用户手动填写本周总结和下周计划

Step 5: 逐模块保存草稿
  → 详见 references/weekly-draft.md
  → mcp__huanxi__weekly_report_save(module_id, year, week_number, content, next_week_plan)

Step 6: 确认并提交
  → 展示所有模块最终内容，等待用户明确确认（"确认"/"提交"/"好的"等）
  → ⚠️ 未收到确认前，禁止调用 weekly_report_submit
  → mcp__huanxi__weekly_report_submit(module_id)
```

---

## Shortcuts

| 指令 | 说明 |
|------|------|
| `+check` | 查看本周周报状态（草稿/已提交） |
| [`+draft`](references/weekly-draft.md) | 基于本周负责人日报 AI 生成草稿 |
| `+submit` | 提交周报（必须先确认） |
| `+withdraw` | 撤回已提交周报 |

---

## +check：查看本周状态

```
1. 确认 leader 模块列表（同 Step 0）
2. 若无 leader 模块：告知无需提交周报
3. mcp__huanxi__weekly_report_get_batch(year, week, module_ids)
4. 展示各模块周报状态：
   - submitted：已提交，展示摘要
   - draft：草稿中，展示已填内容
   - empty：未填，建议运行 +draft
```

---

## +withdraw：撤回周报

```
1. 确认 leader 模块（从 modules.json 缓存中取）
2. 若有多个 leader 模块，询问要撤回哪个模块的周报
3. 告知撤回影响（状态变为草稿，可重新编辑），等待用户确认
4. mcp__huanxi__weekly_report_withdraw(module_id)
   （默认撤回当周；如需撤回历史周：传 year + week_number）
5. 告知成功，可重新编辑后再次提交
```

---

## 关键约束

- **仅负责人可提交**：首先检查 `my_role == 'leader'`，非负责人直接告知无需操作
- **禁止自动提交**：`weekly_report_submit(module_id)` 前必须展示全部内容并等待用户确认
- **year 存 ISO year**：高频出错点，必须使用 `isocalendar()[0]`，不要用 `date.year`
- 每个模块独立提交，有多个模块时逐一处理
- 撤回后可重新编辑，不影响当前状态