# Weekly Report Writer

> 综合 Obsidian 笔记库中的文档，基于最近的文档、上一份报告和项目背景生成周报

- Skill: `cafe3310/weekly-report-writer` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add cafe3310/weekly-report-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cafe3310/weekly-report-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: cafe3310 (https://skillmd.com/u/cafe3310)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/cafe3310/weekly-report-writer

---


# Weekly Report Writer (周报撰写助手)

## 概览

此技能自动化了周报/双周报的创建过程。它通过查找指定日期范围内的所有相关文档，阅读其内容，并根据模板或分层结构合成信息。它特别注重项目的连续性（追踪上一份报告的任务状态）和内容的深度（通过链接溯源）。

## 何时使用

当用户要求：
- “写我的周报”或“起草本周摘要”。
- 总结两个日期之间的进度。
- 基于上一份报告和一组新文档创建新报告。

此技能在文档知识库，如 Obsidian 知识库中特别有效。

## 工作流

遵循此工作流生成报告。

### 第一步：收集用户输入

在开始之前，与用户确认以下信息：
1.  **开始日期**：报告周期的开始。
2.  **结束日期**：报告周期的结束。
3.  **仓库文件名是否包含日期前缀**：确认文件命名约定（如 `YYYY-MM-DD-描述.md`）。
4.  **上一份报告路径**：上一份周报的文件路径。这对追踪正在进行的任务至关重要。
5.  **笔记库目录**：文档存储库的根目录（例如他们的 Obsidian vault 路径）。
6.  **（可选）报告模板路径**：如果用户有特定模板，请提供其路径。
7.  **（可选）项目背景路径**：总结更大组织所有项目的文档路径（如果有）。

### 第二步：查找文档

查找日志：使用用户提供的 `笔记库目录` 和日期范围，查找日期范围匹配的所有 Markdown 文件。

### 第三步：与用户确认文件列表

向用户展示找到的文件列表（日志 + 探测到的模板）。请用户确认列表，并反馈任何应 **重点关注** 或 **跳过** 的文件。
一般来说，摘抄的文档、语音转写原文日志等应跳过；
每日工作小结、会议纪要、项目更新等应重点关注。
个人 Idea 或 side project 要记录在第一部分的末尾一节。

### 第四步：阅读、深度溯源与合成

确认后，阅读所有文件的内容。过程中要注意：

几个注意事项：
- **链接追踪**：在阅读每日摘要/日志时，如果遇到一个指向另一个文档的“关键事项”，且包含 `[[文档链接]]`，你应该使用工具读取那个被链接的文档。原因是，每日摘要通常只是一句话（“完成了... ”），而高质量周报需要源文档中的具体产出、方法和数据。
- **信息合成**：过程中，合成信息时要注意：
  - 追踪“上一份报告”中的项目，凸显其进展。
  - 识别待办 (`🟥`)、已完成 (`🟩`)、进行中 (`🟨`) 和新想法 (`💡`)，标记各个事项。
  - **待办继承**：上一份报告中任何 `🟥` (待办) 或 `🟨` (进行中) 的项目，**必须** 带入新报告的“待办/积压”区域，除非在新报告中已经包括并明确标记为 `🟩` (已完成)。

### 第五步：起草报告 (分层输出)

起草报告。如果在第二步中找到了特定模板，请严格遵循它。否则，使用**标准分层结构**：

**第一部分：个人状态同步**
- 这是个人日志。
- **受众**：自己 / 知识库。
- **内容**：详细的技术背景、指向深度文档的链接、个人思考 (`💡`) 和具体状态更新。保留 `[[Wiki Link]]` 格式。

**第二部分：团队对外同步**
- 这是团队报告中「自己负责的部分」。
- **受众**：管理者 / 团队。
- **内容**：高层级摘要。
    - **关键进展**：交付了什么？（关注价值）。
    - **风险/卡点**：需要什么支持？
    - **下一步计划**：近期计划是什么？
    - **提及**：使用 `@用户` 格式标记负责人。

**报告文件名**：使用文档库的文件名定义，和之前的报告文件名风格保持一致。

### 第六步：遗漏检查 (Gap Analysis)

草稿生成后，针对高价值产出进行一轮“遗漏检查”。提醒用户「检查草稿，若有遗漏，请补充」。然后按用户反馈对草稿做编辑更新。