# Review

> Review Skill — 周/月复盘引擎（v2 全量扫描）

- Skill: `zzyong24/review-2` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx get-skill add zzyong24/review-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zzyong24/review-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zzyong24 (https://skillmd.com/u/zzyong24)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zzyong24/review-2

---

# Review Skill — 周/月复盘引擎（v2 全量扫描）

## 功能概述

**全量扫描** vault/space 下所有 .md 文件，按 Frontmatter 中的 `created`/`modified` 时间戳筛选目标周期内的内容，自动按 type/topic 分类聚合。

**核心设计哲学：不硬编码任何目录列表，新增 topic/type 自动被覆盖。**

## 工具清单

| 工具 | 说明 |
|------|------|
| `weekly_review(week_offset, prompt_name)` | 全量扫描聚合本周数据（IO） |
| `save_weekly_review(...)` | 保存 AI 生成的周报（IO） |
| `monthly_review(month_offset, prompt_name)` | 全量扫描聚合本月数据（IO） |
| `save_monthly_review(...)` | 保存 AI 生成的月报（IO） |

## 设计原则

遵循 **Tool → AI → Tool** 模式：
1. `weekly_review` / `monthly_review` 全量扫描 vault 聚合数据（IO）
2. AI 基于素材生成周报/月报内容（智能）
3. `save_weekly_review` / `save_monthly_review` 保存结果（IO）

## 数据聚合范围

### v1（旧）— 硬编码 5 个数据源

```
❌ worklog → reflections → found → plans → events → 完
```

### v2（新）— 全量扫描，自动覆盖所有内容

```
✅ vault/space/crafted/**/*.md  → 按 Frontmatter 时间筛选
✅ vault/space/found/**/*.md    → 按 Frontmatter 时间筛选
```

自动覆盖的内容类型（无需手动注册）：

| type | 来源 | 说明 |
|------|------|------|
| reflection | crafted/reflections/ | 深度反思 |
| card | found/ | 知识卡片（阅读输入） |
| note | crafted/{topic}/ | 各类笔记 |
| worklog | crafted/work/worklog/ | 工作日志 |
| article | crafted/writing/ | 文章 |
| plan | crafted/*/plans/ | 学习计划 |
| event | crafted/lifeos/events/ | LifeOS 事件 |
| tracker | crafted/tracker/ | 创作追踪 |
| project | crafted/project/ | 项目文档 |
| prompt | crafted/prompts/ | Prompt |
| review | crafted/reviews/ | 复盘（自动跳过，不纳入素材） |

### 时间筛选优先级

1. Frontmatter `created` 字段
2. Frontmatter `modified` 字段
3. 文件名中的日期（如 `20260318_xxx.md`）
4. 文件系统 mtime（兜底）

### 返回数据结构

```python
{
    "week_label": "2026-W12",
    "stats": {
        "total": 25,
        "by_type": {"note": 8, "reflection": 4, ...},
        "by_topic": {"creation": 6, "reading": 5, ...},
        "crafted_count": 19,
        "found_count": 6,
    },
    "items_by_type": {"note": [...], "card": [...], ...},
    "items_by_topic": {"creation": [...], ...},
    "all_items": [...],
}
```

## 支持 Prompt 风格调整

通过 `prompt_name` 参数引入 Prompt 库中的风格模板：

```python
weekly_review(prompt_name="tools/周报风格")
```

模板位置：`space/crafted/prompts/{category}/{name}.md`

## 输出位置

- 周报：`space/crafted/reviews/weekly_{week_label}.md`
- 月报：`space/crafted/reviews/monthly_{month_label}.md`

