# Jw Agenda Weekly Review

> Weekly review: aggregate daily logs, compute completion rate and time allocation, generate summary, list carry-over items; archive daily files older than 2 weeks into YYYYMM subdirs. Triggers: '周总结', '本周回顾', 'weekly review', '运行 weekly-review'.

- Skill: `janewu77/jw-agenda-weekly-review` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add janewu77/jw-agenda-weekly-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/janewu77/jw-agenda-weekly-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: janewu77 (https://skillmd.com/u/janewu77)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/janewu77/jw-agenda-weekly-review

---


# Weekly Review（周回顾）

汇总本周日志与 todo，统计完成率和时间分配，生成周总结报告，识别转入下周的事项。

**级联状态同步原则**：生成周回顾后，**必须从下往上逐层检查并同步完成状态**，确保各层规划反映实际进度。数据来源是本周的每日日志（daily log）和每日 todo，以此为依据逐层向上同步：

1. **每日日志/日计划**（daily/{日期}-log.md、{日期}-todo.md）→ 这是事实来源，汇总本周各天的完成情况
2. **周规划**（weekly/Week{W}-plan.md）→ 根据日志汇总的实际完成情况，标记各任务的完成 `[x]` 或未完成状态
3. **月规划**（monthly/YYYY-MM-plan.md）→ 若本周完成的事项属于月目标/重点任务，在月规划对应条目旁标记完成状态
4. **年规划**（若存在）→ 若本周完成的事项与年度目标相关，标记进展

**注意**：对上层规划文件（周/月/年）只做**轻量标记**（完成 `[x]`、进行中等），不改动原有规划内容。详细分析保留在周回顾文件中。每一层只在确实受影响时才修改，但必须逐层检查，不可跳过。

## 安装前提

本 Skill 仅依赖用户 workspace 下存在 **jw-agenda 根目录**（默认 `jw-agenda-data`，可经 workspace 根目录的 `.jw-agenda.json` 或 `jw-agenda.json` 配置）及子目录 monthly、weekly、daily、tasks。约定与脚本已随本 Skill 安装，无需用户另行复制。先按 conventions 解析 jw-agenda 根目录。

## 约定

开始前读取**本 Skill 的 `assets/conventions.md`** 获取文件命名、路径和周数规则。

## Workflow

### Step 1: 确定回顾范围

使用本 Skill 的 `assets/scripts/date_utils.py` 计算本周/上周的日期范围和年内周数（1–52）。

- **默认**：本周（周一至周日）
- 若用户说「上周回顾」，则使用上周日期范围

### Step 2: 汇总数据

读取本周范围内的所有文件：

**主要来源**：
- `{agendaRoot}/daily/{日期}-log.md`：逐日读取，提取已完成、未完成、时间分配、学习/产出
- `{agendaRoot}/daily/{日期}-todo.md`：逐日读取勾选状态，交叉验证日志

**可选来源**：
- `{agendaRoot}/weekly/Week{W}-plan.md`：对比计划 vs 实际

记录哪些天有数据、哪些天缺失。

### Step 3: 统计分析

**完成率**：`已勾选项总数 / 总项数 × 100%`，某天无 todo 文件则不纳入。分别统计高/中/低优先级。

**时间分配**：从每日日志的「时间分配」部分提取，按类别汇总。

**产出汇总**：从每日日志的「学习/产出」部分汇总为列表。

### Step 4: 生成周总结

使用 `assets/review-template.md` 模板，填充后写入：

**路径**：`{agendaRoot}/weekly/Week{W}-review.md`（W = 年内周数，1–52，与周规划命名一致）

**内容**：整体概览（完成率、主要成就）、分类统计、未完成/待处理、**转入下周**清单。

### Step 5: 从下往上级联同步状态

基于 Step 2-3 从每日日志和每日 todo 中汇总的实际完成情况，逐层向上同步：

#### 5a: 周规划（weekly/Week{W}-plan.md）

- 根据每日日志汇总的实际完成情况，在周规划中标记各任务状态：完成 `[x]`、未完成保持 `[ ]`、进行中标记 `（进行中）`
- **只更新状态标记，不改动规划内容本身**

#### 5b: 月规划（monthly/YYYY-MM-plan.md）

- 检查本周完成的任务是否属于月目标或月重点任务
- 若属于，在月规划对应条目旁标记完成状态或进展
- **只做轻量标记，不改动规划结构**

#### 5c: 年规划（若存在）

- 检查本周完成的任务是否与年度目标相关
- 若相关，在年规划对应条目旁标记进展
- **只做轻量标记**

**注意**：每一层只在确实受影响时才修改，但必须逐层检查，不可跳过。

### Step 6: 归档 daily 目录（二周以前）

按 `conventions.md` 中的 **daily 目录归档规则** 执行：

- 扫描 `{agendaRoot}/daily/` 根下的 `YYYY-MM-DD-todo.md`、`YYYY-MM-DD-log.md` 文件
- 若文件日期早于「今天 − 14 天」，则移入 `{agendaRoot}/daily/YYYYMM/` 子目录（如 `202601/`、`202602/`）
- 若子目录不存在则创建；同一月的文件归入同一子目录
- 归档后向用户说明移入了多少文件、目标子目录

### Step 7: 汇报

说明：周总结文件路径、完成率、时间分配要点、转入下周事项数量、归档文件数（若有）、**已同步状态的所有文件路径**。

## Error Handling

| 情况 | 处理 |
|------|------|
| 部分日期缺少日志 | 用已有日志统计，在报告中标注缺失日期 |
| 全部日期无日志 | 询问用户是否仍需生成空框架 |
| 日志中无时间分配信息 | 跳过时间统计，在报告中标注 |
| 周总结已存在 | 向用户确认是否覆盖，默认不覆盖 |
| 无 todo 文件 | 仅统计日志中的完成/未完成项 |

## 与其他 Skill 的配合（可选）

- 若安装了 **daily-log**：本 Skill 汇总其产出的每日日志。未安装时从 daily todo 文件推断完成情况。
- 若安装了 **daily-todo**：每日 todo 的完成状态用于计算完成率。未安装时从日志推断。
- 若安装了 **weekly-plan**：下周生成周规划时，可读取本 Skill 的「转入下周」部分。未安装时不影响本 Skill。

## Resources

- `assets/review-template.md`：周总结输出模板
- `assets/conventions.md`：约定
- `assets/scripts/date_utils.py`：日期计算脚本