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 模式:
weekly_review/monthly_review全量扫描 vault 聚合数据(IO)- AI 基于素材生成周报/月报内容(智能)
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/ | 复盘(自动跳过,不纳入素材) |
时间筛选优先级
- Frontmatter
created字段 - Frontmatter
modified字段 - 文件名中的日期(如
20260318_xxx.md) - 文件系统 mtime(兜底)
返回数据结构
{
"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 库中的风格模板:
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