weekly-report-writer
Weekly Report Writer (周报撰写助手)
概览
此技能自动化了周报/双周报的创建过程。它通过查找指定日期范围内的所有相关文档,阅读其内容,并根据模板或分层结构合成信息。它特别注重项目的连续性(追踪上一份报告的任务状态)和内容的深度(通过链接溯源)。
何时使用
当用户要求:
- “写我的周报”或“起草本周摘要”。
- 总结两个日期之间的进度。
- 基于上一份报告和一组新文档创建新报告。
此技能在文档知识库,如 Obsidian 知识库中特别有效。
工作流
遵循此工作流生成报告。
第一步:收集用户输入
在开始之前,与用户确认以下信息:
- 开始日期:报告周期的开始。
- 结束日期:报告周期的结束。
- 仓库文件名是否包含日期前缀:确认文件命名约定(如
YYYY-MM-DD-描述.md)。 - 上一份报告路径:上一份周报的文件路径。这对追踪正在进行的任务至关重要。
- 笔记库目录:文档存储库的根目录(例如他们的 Obsidian vault 路径)。
- (可选)报告模板路径:如果用户有特定模板,请提供其路径。
- (可选)项目背景路径:总结更大组织所有项目的文档路径(如果有)。
第二步:查找文档
查找日志:使用用户提供的 笔记库目录 和日期范围,查找日期范围匹配的所有 Markdown 文件。
第三步:与用户确认文件列表
向用户展示找到的文件列表(日志 + 探测到的模板)。请用户确认列表,并反馈任何应 重点关注 或 跳过 的文件。 一般来说,摘抄的文档、语音转写原文日志等应跳过; 每日工作小结、会议纪要、项目更新等应重点关注。 个人 Idea 或 side project 要记录在第一部分的末尾一节。
第四步:阅读、深度溯源与合成
确认后,阅读所有文件的内容。过程中要注意:
几个注意事项:
- 链接追踪:在阅读每日摘要/日志时,如果遇到一个指向另一个文档的“关键事项”,且包含
[[文档链接]],你应该使用工具读取那个被链接的文档。原因是,每日摘要通常只是一句话(“完成了... ”),而高质量周报需要源文档中的具体产出、方法和数据。 - 信息合成:过程中,合成信息时要注意:
- 追踪“上一份报告”中的项目,凸显其进展。
- 识别待办 (
🟥)、已完成 (🟩)、进行中 (🟨) 和新想法 (💡),标记各个事项。 - 待办继承:上一份报告中任何
🟥(待办) 或🟨(进行中) 的项目,必须 带入新报告的“待办/积压”区域,除非在新报告中已经包括并明确标记为🟩(已完成)。
第五步:起草报告 (分层输出)
起草报告。如果在第二步中找到了特定模板,请严格遵循它。否则,使用标准分层结构:
第一部分:个人状态同步
- 这是个人日志。
- 受众:自己 / 知识库。
- 内容:详细的技术背景、指向深度文档的链接、个人思考 (
💡) 和具体状态更新。保留[[Wiki Link]]格式。
第二部分:团队对外同步
- 这是团队报告中「自己负责的部分」。
- 受众:管理者 / 团队。
- 内容:高层级摘要。
- 关键进展:交付了什么?(关注价值)。
- 风险/卡点:需要什么支持?
- 下一步计划:近期计划是什么?
- 提及:使用
@用户格式标记负责人。
报告文件名:使用文档库的文件名定义,和之前的报告文件名风格保持一致。
第六步:遗漏检查 (Gap Analysis)
草稿生成后,针对高价值产出进行一轮“遗漏检查”。提醒用户「检查草稿,若有遗漏,请补充」。然后按用户反馈对草稿做编辑更新。
More from cafe3310/public-agent-skills
im-local-kb
IM 知识整理和分析技能,专注于从聊天记录中提取高价值的知识。
30project-learner
结构化交互式学习助手,当用户希望学习项目相关知识、特定代码文件或底层技术时使用此技能,它会将学习过程记录为持久化的 Markdown 日志。
24media-organizer
与用户协作,根据项目约定,将媒体文件目录组织成结构化、分类化和文档化的格式。
19doc-todo-log-loop
基于日志记录驱动的轻量级项目开发和管理方案。如果用户在项目章程提及,应使用此技能。
18project-design-concept-organizer
作为一个 doc-todo-log-loop 的补充技能,用于在开发过程中整理、归纳项目的设计理念、核心概念和架构模式。旨在将分散的开发决策和隐性知识转化为系统的设计文档。
15git-snapshot-rollback
在 Git 开发中,当需要放弃当前尝试并回退到某个历史提交时使用。它会自动将当前状态存档至 archive/ 分支,并在 ARCHIVE.md 中建立双向链接(来源与目标),确保开发决策流的可追溯性。适用于需要安全回退且保留失败尝试上下文的场景。
15