weekly-report-writer

Weekly Report Writer (周报撰写助手)

概览

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

何时使用

当用户要求：

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

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

核心准则

1. 语言风格：去大词、去黑话、极简平实

• 以朴素事实与具体动作为锚：句式直接采用「动词 + 具体产出/方案/结论」，严禁堆砌企业大词与黑话（禁用“赋能”、“拉通对齐”、“打法”、“抓手”、“深度闭环”、“降载”、“合规治理”等浮夸修辞，替换为“打包”、“反馈”、“接口限流”、“排期开发”等朴素动作）。
• 保留关键技术参数与避坑细节：记录具体框架名称、运行环境、关键配置参数、性能指标与排查出的实际根因。
• 草案与规划必须明确边界：凡属初步设想、架构提案类事项，应以「草案规划 - ...」注明，并写明「目前仅为草案，待进一步确认后再执行」，避免将初步讨论表述为已进入实质开发。
• 观察与待定事项收拢文末：对于尚无实质动作的外部动态观察、待排期事项，收敛至文末板块，注明「目前保持关注，暂未展开具体动作」。

2. 事情聚类方案：按项目/领域主线聚合（严禁流水账）

周报严禁按工作日流水账罗列，按 3~5 个项目模块 / 技术领域进行聚类（例如）：

1. 核心模块开发与版本交付：关键功能实现、原型构建、交付物打包、问题排查与修复。
2. 架构设计与技术方案规划：模块接口对接、技术选型验证、工具链改进与架构设计草案。
3. 运行监控与问题改进：系统运行指标观察、性能瓶颈分析、用户反馈处理与自动化脚本编写。
4. 工程基建与稳定性维护：配置管理、安全策略、常规功能迭代与体验优化。
5. 💡 关注事项与待办承接：固定放在末尾，归集暂无直接动作的观察项，以及移交或延后的积压待办。

3. 符号体系定义

• 🟩：已完成（有文档/记录支撑的工作成果）。
• 🟨：进行中 / 推进中。
• 🟥：待办 / 搁置（统一归入 🟥，不再单设符号）。
• 💡：新想法 / 个人思考 / 关注事项。
• ❇️：代码 / Agent 侧工作。指源自本地代码仓库提交或 Agent 会话、未在当周 Obsidian 笔记中记录的工程进展，用 ❇️ 标注。

4. 排版规范：三层事项结构、纯文本无格式约束与行尾脚注引用

1. 单层紧凑结构（彻底废弃冗余的“团队对外同步”）：
   • 默认直接输出单层 ## 02. 状态同步，按 4~5 个业务板块推进。
   • 严禁默认生成与个人状态高度重叠（40%+ 重复率）的“第二部分：团队对外同步”，除非用户特别明确要求。
2. 「领域 -> 事项 -> 四要素」三层描述结构：
   • 第一层（领域）：使用三级标题 ### 1. {业务主线 / 领域名称}
   • 第二层（事项）：使用五级标题 ##### {具体事项名称}（严禁将不同事项的“做了什么”与“还要做什么”打散混排在同一个大列表下）
   • 第三层（四要素）：在每个事项下以无序列表 - 依次展开（严禁加粗字段名）：
     • - 任务目标：{简述该事项的目标与定位}[^N]。
     • - 🟩 做了什么：{平实描述具体动作、技术细节与工程产出（含 ❇️ 项）}[^M]。
     • - 效果：{当前已取得的阶段性结果、数据指标或就绪状态}。
     • - 🟨 还要做什么：{下一步计划、承接的未完结待办或外部依赖}。
3. 全文纯文本约束（严禁粗体与行内代码反引号）：
   • 生成的周报正文中，全文严禁使用 **粗体**、**粗体冒号：** 以及 `codefences`（行内反引号代码格式），全部使用不带格式的纯文本。
4. 正文行尾脚注引用（Footnotes）：
   • 正文严禁在加粗标题或句子中间硬插长双链：双链过长会切碎中文阅读语流。
   • 统一收纳至行尾：每条进展只在最末尾（句号后）追加角标 [^N]（如 ... 完成模块重构 [^2]。 或 ... 补充边界用例测试 [^3] [^4]。）。严禁放在加粗小标题后或句子半中间。
   • 01 导语去重：01 文档生成说明中仅保留简明导言（如 对照继承上一期周报 [^1] 的待办事项，文中所涉具体方案与交付文档见文末引用列表。），不再重复罗列长篇清单。
   • 文末统一收口：在文末设置 ## 03. 参考文档与来源，统一展开 [^1]: [[...]]。在 Obsidian 实时预览或阅读视图下，正文自动渲染为精美上标，悬停即弹出笔记预览，点击直达文末并支持回跳锚点 ↩。